Plx使用手册学习------6 PlxPci_DeviceFind
作者：互联网
Syntax:
PLX_STATUS
PlxPci_DeviceFind(
PLX_DEVICE_KEY *pKey,
U16 DeviceNumber
);
PLX Chip Support:
All devices
Description:
Locates a specific PCIe device and fills in the corresponding device key information.
定位特定的PCIe设备并填写相应的设备密钥信息。
Parameters:
pKey
Pointer to a PLX_DEVICE_KEY structure containing the search criteria
DeviceNumber
The 0-based index of the device number to select. Refer to Notes section below for details.
Return Codes:
| Code | Description |
| ApiSuccess | The function returned successfully |
| ApiNullParam | One or more parameters is NULL |
| ApiNoActiveDriver | A valid PLX driver is not loaded in the system |
| ApiInvalidDeviceInfo | The key does not match an installed device |
Notes:
The fields in the PLX_DEVICE_KEY structure will be used to locate a device. If a field is set to
PCI_FIELD_IGNORE, then it is ignored in the comparison. If a device matches the criteria, all ignored fields in
the key will be filled in with their respective value.
The DeviceNumber parameter is an index that specifies which device to select, where ‘0’ is the first device. If
multiple devices match the criteria, the DeviceNumber specifies which device to select.
Usage:
PLX_STATUS rc;
PLX_DEVICE_KEY DeviceKey;
// Clear key structure to find first device
memset(&DeviceKey, PCI_FIELD_IGNORE, sizeof(PLX_DEVICE_KEY));
rc =
PlxPci_DeviceFind(
&DeviceKey,
0 // Select 1st device matching criteria
);
if (rc != ApiSuccess)
{
// ERROR – Unable to locate matching device
}
// Search for the third device matching a specific Vendor ID
memset(&DeviceKey, PCI_FIELD_IGNORE, sizeof(PLX_DEVICE_KEY));
// Specify Vendor ID
DeviceKey.VendorId = 0x10b5; // PLX Vendor ID
rc =
PlxPci_DeviceFind(
&DeviceKey,
2 // Select 3rd device matching criteria
);
if (rc != ApiSuccess)
{
// ERROR – Unable to locate matching device
}
标签：DeviceFind,DeviceKey,PLX,DEVICE,PlxPci,使用手册,KEY,device,matching 来源： https://blog.csdn.net/u014626607/article/details/93972172