SetupDiGetDeviceInstanceId

BOOLEAN
    SetupDiGetDeviceInstanceId(
        IN HDEVINFO  DeviceInfoSet,
        IN PSP_DEVINFO_DATA  DeviceInfoData 
        OUT PTSTR  DeviceInstanceId,
        IN DWORD  DeviceInstanceIdSize, 
        OUT PDWORD  RequiredSize    /* optional */
        );

SetupDiGetDeviceInstanceId retrieves the device instance ID associated with a device information element.

Parameters

DeviceInfoSet

Supplies a handle to the device information set that contains the device information element to retrieve.

DeviceInfoData

Supplies a pointer to the SP_DEVINFO_DATA structure for the device information element whose ID is to be retrieved.

DeviceInstanceId

Supplies a pointer to the character buffer that will receive the ID for the specified device information element.

DeviceInstanceIdSize

Supplies the size, in characters, of the DeviceInstanceId buffer.

RequiredSize

Supplies a pointer to the variable that receives the number of characters required to store the device instance ID.

Return Value

The function returns TRUE if it is successful. Otherwise it returns FALSE and the logged error can be retrieved with a call to GetLastError.

See Also

SetupDiCreateDeviceInfo, SetupDiCreateDevRegKey, SetupDiOpenDeviceInfo, SetupDiOpenDevRegKey