Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File4.15.5  find_pci_device                                            TOS

 Name:         »find_pci_device« - Returns a device handle for a 
               device that matches the given Device and Vendor ID.

 Opcode:       300

 Syntax:       int32_t find_pci_device( int32_t id, int16_t index);

 Description:  This functions returns a device handle for a device 
               that matches the given Device and Vendor ID. A driver 
               can query multiple devices with the same Device and 
               Vendor ID by starting with index = 0,1,2,... and 
               calling this function until PCI_DEVICE_NOT_FOUND is 
               returned.

               As a special case, Vendor ID $FFFF can be used to query 
               all cards found in the system, the specified Device ID 
               is ignored in that case.



                id          Device ID in bits 31..16 (0 - $FFFF)
                            Vendor ID in bits 15..0 (0 - $FFFE)

                index       Index of card (0 - number of cards with 
                            these IDs)

 Return value: Device handle for a device or PCI_DEVICE_NOT_FOUND.

 Availability: PCI-BIOS V2.00

 Group:        PCI-BIOS

 See also:     Binding   find_pci_classcode