BOOLEAN
SetupDiGetDriverInfoDetail(
IN HDEVINFO DeviceInfoSet,
IN PSP_DEVINFO_DATA DeviceInfoData, /* optional */
IN PSP_DRVINFO_DATA DriverInfoData,
OUT PSP_DRVINFO_DETAIL_DATA DriverInfoDetailData, /* optional */
IN DWORD DriverInfoDetailDataSize,
OUT PDWORD RequiredSize /* optional */
);
SetupDiGetDriverInfoDetail retrieves detailed information for a specified driver.
Parameters
DeviceInfoSet
Supplies a handle to the device information set that contains a driver information structure for which to retrieve details.
DeviceInfoData
Supplies a pointer to an SP_DEVINFO_DATA structure that contains a driver information structure for which to retrieve details. If this parameter is not specified, the driver referenced is a member of the global class driver list owned by the device information set.
DriverInfoData
Supplies a pointer to an SP_DRVINFO_DATA structure that specifies the driver for which details are to be retrieved.
DriverInfoDetailData
Supplies a pointer to an SP_DRVINFO_DETAIL_DATA structure that receives detailed information about the specified driver. If this parameter is not specified, DriverInfoDetailDataSize must be 0. If this parameter is specified, the cbSize field of this structure must be set to the size, in bytes, of the structure before calling SetupDiGetDriverInfoDetail.
DriverInfoDetailDataSize
Supplies the size, in bytes, of the DriverInfoDetailData buffer.
RequiredSize
Supplies a pointer to a variable that receives the number of bytes required to store the detailed driver information. This value includes both the size of the structure and the additional bytes required for the variable-length character buffer at the end that holds the hardware ID and the compatible IDs MULTI_SZ list.
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.
Comments
If the specified driver information member and the caller-supplied buffer are both valid, this function is guaranteed to fill in all static fields in the SP_DRVINFO_DETAIL_DATA structure and as many IDs as possible in the variable-length buffer at the end while still maintaining MULTI_SZ format. In this case, the function returns FALSE and a call to GetLastError returns ERROR_INSUFFICIENT_BUFFER. If specified, RequiredSize contains the total number of bytes required for the structure with all IDs.
See Also