pci_find_device()

Find the PCI device with a given device ID and vendor ID

Synopsis:

#include <hw/pci.h>

int pci_find_device( unsigned device,
                     unsigned vendor,
                     unsigned index,
                     unsigned* bus,
                     unsigned* dev_func );

Library:

libc

Description:

The pci_find_device() function returns the location of the nth PCI device that has the specified Device ID and Vendor ID.

The arguments are as follows:

device

The Device ID.

vendor

The Vendor ID.

index

The index (n) of the device or function sought.

bus

The Bus Number of the device or function found.

dev_func

The Device or Function ID of the nth device or function found with the specified Device and Vendor IDs. The device number is in bits 7 through 3, and the function number in bits 2 through 0.

You can find all the devices having the same Device and Vendor IDs 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.

Classification:

QNX 6

See also:

pci_attach(), pci_attach_device(), pci_detach(), pci_detach_device(), pci_find_class(), 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()