SetupDiGetDeviceRegistryProperty
BOOLEAN
SetupDiGetDeviceRegistryProperty
IN HDEVINFO DeviceInfoSet,
IN PSP_DEVINFO_DATA DeviceInfoData,
IN DWORD Property,
OUT PDWORD PropertyRegDataType, /* optional */
OUT PBYTE PropertyBuffer,
IN DWORD PropertyBufferSize,
OUT PDWORD RequiredSize /* optional */
);
SetupDiGetDeviceRegistryProperty retrieves the specified property from the Plug and Play device storage location in the registry.
Parameters
DeviceInfoSet
Supplies a handle to the device information set containing information about the device instance for which to retrieve a Plug and Play registry property.
DeviceInfoData
Supplies a pointer to an SP_DEVINFO_DATA structure indicating the device instance for which to retrieve the Plug and Play property.
Property
Supplies an ordinal specifying the property to be retrieved. Can be one of the following values:
| Code | Property |
| SPDRP_DEVICEDESC (0x00) | DeviceDesc |
| SPDRP_HARDWAREID (0x01) | HardwareID |
| SPDRP_COMPATIBLEIDS (0x02) | CompatibleIDs |
| SPDRP_NTDEVICEPATHS (0x03) | NtDevicePaths |
| SPDRP_SERVICE (0x04) | Service |
| SPDRP_CONFIGURATION (0x05) | Configuration |
| SPDRP_CONFIGURATIONVECTOR (0x06) | ConfigurationVector |
| SPDRP_CLASS (0x07) | Class |
| SPDRP_CLASSGUID (0x08) | ClassGUID |
| SPDRP_DRIVER (0x09) | Driver |
| SPDRP_CONFIGFLAGS (0x0A) | ConfigFlags |
| SPDRP_MFG (0x0B) | Mfg |
| SPDRP_FRIENDLYNAME (0x0C) | FriendlyName |
PropertyRegDataType
Supplies a pointer to a variable to receive the data type of the property being retrieved. This is one of the standard registry data types.
PropertyBuffer
Supplies a pointer to a buffer to receive the property being retrieved.
PropertyBufferSize
Supplies the length, in bytes, of PropertyBuffer.
RequiredSize
Supplies a pointer to a variable to receive the number of bytes required to store the requested property in PropertyBuffer.
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