pci_device_find_capid

Synopsis:

#include <pci/pci.h>

int_t pci_device_find_capid_next( pci_bdf_t bdf,
                                  pci_capid_t capid,
                                  int_t start_idx );

Arguments:

bdf: The Bus/Device/Function associated with a device.
capid: The identifier for a capability.
start_idx: The index of a specific capability.

Library:

libpci

Use the -l pci option to qcc to link against this library.

Description:

You can use pci_device_find_capid_next() to locate the next occurrence of a capability which the device identified by bdf supports, starting at the capability index start_idx.

You can locate each instance of a specific capability by using pci_device_find_capid_next() with the index returned from a previous call as long as the returned index is a not a negative value.

In the case a negative value is returned (e.g. -1), calling pci_device_find_capid_next() will return the same value calling pci_device_find_capid() will. Returning a negative value also means that there are no more instances of the specific capability present.

Note: This function doesn't cause a capability module to be loaded.

On success, when a non-negative 0 based index value is returned, you can use it to call pci_device_read_cap().

Returns:

The index for the next occurrence of a specific capability, or -1 if there is not more than one occurrence.

Classification:

QNX Neutrino

Safety:
Cancellation point	No
Signal handler	No
Thread	Yes