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.4  find_pci_classcode                                         TOS

 Name:         »find_pci_classcode« - Return a device handle for a 
               device that matches the given class code.

 Opcode:       301

 Syntax:       int32_t find_pci_classcode( int32_t classcode, int16_t 
               index );

 Description:  This functions returns a device handle for a device 
               that matches the given class code.

               A driver can query multiple devices with the same class 
               code by starting with index = 0,1,2,... and calling 
               this function until PCI_DEVICE_NOT_FOUND is returned.



                classcode   class code in bits 23..0


                            Bit 23 ..16 Base class (0 - $FF)
                            Bit 15 .. 8 Sub class (0 - $FF)
                            Bit 7 .. 0 Programming Interface (0 - $FF)

                            Mask in bits 26..24
                            Bit 26: (0: compare base class, 1: ignore 
                            it)
                            Bit 25: (0: compare sub class, 1: ignore 
                            it)
                            Bit 24: (0: compare Progr. Interface, 1: 
                            ignore it)

                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_device