RMDevIDToHandleList

This service is supported by both rminfo.dll and rmcalls.lib. It returns the list of handles of detect nodes that match the device IDs.

Syntax
RMDevIDToHandleList(IDType, DeviceID,      FunctionID, CompatibleID, VendorID,       SerialNumber, SearchFlags, hStartNode,       pHndList);

Parameters

 * IDType (IDTYPE) - input : The type of device ID. The following values are valid:
 * RM_IDTYPE_RM : Internal to Resource Manager.
 * RM_IDTYPE_EISA : EISA (also used for ISA PNP).
 * RM_IDTYPE_PCI : PCI device IDs.
 * RM_IDTYPE_LEGACY : Legacy device ID not defined by Intel.


 * DeviceID (DEVID) - input : Uniquely identifies the particular device or adapter.


 * FunctionID (DEVID) - input : Uniquely identifies a function located on a multi-function adapter.


 * CompatibleID (DEVID) - input : Provides the device IDs of other compatible devices.


 * VendorID (VENDID) - input : Provides the vendor ID for the device.


 * SerialNumber (SERNUM) - input : Provides the serial number for the device.


 * SearchFlags (ULONG) - input : Indicates the type of search to be executed. The following combination of searches are valid:


 * SEARCH_ID_DEVICEID : Search on adapter ID only.
 * SEARCH_ID_FUNCTIONID : Search on function ID only.
 * SEARCH_ID_COMPATIBLEID : Search on compatible ID only.


 * hStartNode (HDETECTED) - input : The handle of the Resource Manager node at which to start the search. The following pseudohandles are supported:


 * HANDLE_PREVIOUS_DETECTED : Previously detected nodes.
 * HANDLE_CURRENT_DETECTED : Current detected nodes.


 * pHndList (PHANDLELIST) - output : Pointer to array of detected handles that match the detected IDs.

Return Code

 * rc (APIRET) - returns : On systems where the Resource Manager driver is not installed, the library interface code will return RMRC_NOT_INSTALLED.

RMRC_BAD_DETECTHANDLE RMRC_INVALID_PARM_VALUE RMRC_NULL_POINTER RMRC_SUCCESS

C

 * 1) include 
 * 2) include 

IDTYPE        IDType; DEVID         DeviceID; DEVID         FunctionID; DEVID         CompatibleID; VENDID        VendorID; SERNUM        SerialNumber; ULONG         SearchFlags; HDETECTED     hStartNode; PHANDLELIST   pHndList; APIRET        rc;

rc = RMDevIDToHandleList(IDType, DeviceID,      FunctionID, CompatibleID, VendorID,       SerialNumber, SearchFlags, hStartNode,       pHndList); 