pci_find_class()

Find devices that have a specific class code

Synopsis:

#include <hw/pci.h>

int pci_find_class( unsigned long class_code,
                    unsigned index,
                    unsigned* bus,
                    unsigned* dev_func );

Arguments:

class_code

The class of device or function that you want to find. For a list of class codes, see <hw/pci.h>. You must OR together a class code and a subclass code (e.g. PCI_CLASS_DISPLAY | PCI_SUBCLASS_DISPLAY_XGA).

index

The index of the device or function that you want to find: 0 for the first, 1 for the second, and so on.

bus

The bus number, in the range [0...255].

dev_func

The device or function number of the nth device or function of the given class. The device number is in bits 7 through 3, and the function number in bits 2 through 0.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pci_find_class() function determines the location of the nth PCI device or function that has the specified class code.

---

You must successfully call pci_attach() before calling any of the other PCI functions.

---

You can find all the devices having the same class code by making successive calls to this function, starting with an index of 0, and incrementing it until PCI_DEVICE_NOT_FOUND is returned.

Returns:

PCI_DEVICE_NOT_FOUND

The device or function wasn't found.

PCI_SUCCESS

The device or function was found.

-1

You haven't called pci_attach(), or the call to it failed.

Classification:

QNX Neutrino

See also:

pci_attach(), pci_attach_device(), pci_detach(), pci_detach_device(), pci_find_device(), pci_present(), pci_read_config(), pci_read_config8(), pci_read_config16(), pci_read_config32(), pci_rescan_bus(), pci_write_config(), pci_write_config8(), pci_write_config16(), pci_write_config32()