MSDN原文地址
Windows Driver Kit: Device Installation
CM_Locate_DevNode
The CM_Locate_DevNode function obtains a device instance handle to the device node that is associated with a specified device instance identifier, on the local machine.
CM_Locate_DevNode 函數獲得設備節點的設備實例句柄，關聯本機指定的設備實例標識符。
CMAPI CONFIGRET WINAPI
CM_Locate_DevNode(
OUT PDEVINST pdnDevInst,
IN DEVINSTID pDeviceID, OPTIONAL
IN ULONG ulFlags
);
Parameters
- pdnDevInst
- A pointer to a device instance handle that CM_Locate_DevNode retrieves. The retrieved handle is bound to the local machine.
- 指向CM_Locate_DevNode 取得的設備實例句柄。這個句柄限制在本機。
- pDeviceID
- A pointer to a NULL-terminated string representing a device instance identifier. If this value is NULL, or if it points to a zero-length string, the function retrieves a device instance handle to the device at the root of the device tree.
- 指向一個以NULL結尾的字符串，象征設備實例描述符。如果這個值為NULL，或者指向一個零長度的字符串，函數取得的設備實例句柄是設備樹的根設備。
- ulFlags
- A variable of ULONG type that supplies one of the following flag values that apply if the caller supplies a device instance identifier:
- CM_LOCATE_DEVNODE_NORMAL
- The function retrieves the device instance handle for the specified device only if the device is currently configured in the device tree.
- 僅僅是currently configured
- CM_LOCATE_DEVNODE_PHANTOM
- The function retrieves a device instance handle for the specified device if the device is currently configured in the device tree or the device is a nonpresent device that is not currently configured in the device tree.
currently configured 或者 nonpresent device
- CM_LOCATE_DEVNODE_CANCELREMOVE
- The function retrieves a device instance handle for the specified device if the device is currently configured in the device tree or in the process of being removed from the device tree. If the device is in the process of being removed, the function cancels the removal of the device.
- 正在被移除的設備，如果設備正在被移除，這個函數取消移除動作。
- CM_LOCATE_DEVNODE_NOVALIDATION
- Not used.
Return Value
If the operation succeeds, CM_Locate_DevNode returns CR_SUCCESS. Otherwise, the function returns one of the CR_Xxx error codes that are defined in cfgmgr32.h.
Comments
For information about using device instance handles that are bound to the local machine, see CM_Get_Child.
Requirements
Versions: The CM_Locate_DevNode function is available in Microsoft Windows 2000 and later versions of Windows.
Headers: Declared in cfgmgr32.h. Include cfgmgr32.h.
See Also
CM_Get_Child, CM_Locate_DevNode_Ex