BOOLEAN
SetupDiEnumDriverInfo(
IN HDEVINFO DeviceInfoSet,
IN PSP_DEVINFO_DATA DeviceInfoData, /* optional */
IN DWORD DriverType,
IN DWORD MemberIndex,
OUT PSP_DRVINFO_DATA DriverInfoData
);
SetupDiEnumDriverInfo enumerates the members of a driver information list.
Parameters
DeviceInfoSet
Supplies a handle to the device information set containing a driver information list to enumerate.
DeviceInfoData
Supplies a pointer to an SP_DEVINFO_DATA structure that contains a driver information list to enumerate. If this parameter is not specified, the global driver list owned by the device information set is used (this list is of type SPDIT_CLASSDRIVER).
DriverType
Specifies what type of driver list to enumerate. Must be one of the following values:
SPDIT_CLASSDRIVER
Enumerate a class driver list.
SPDIT_COMPATDRIVER
Enumerate a list of compatible drivers for the specified device. DeviceInfoData must be specified if this flag is set.
MemberIndex
Supplies the 0-based index of the driver information member to retrieve.
DriverInfoData
Supplies a pointer to an SP_DRVINFO_DATA structure to receive information about the enumerated driver.
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
To enumerate driver information set members, an installer should first call SetupDiEnumDriverInfo with the MemberIndex parameter set to 0. It should then increment MemberIndex and call SetupDiEnumDriverInfo until there are no more values. When there are no more values, the function fails and a call to GetLastError returns ERROR_NO_MORE_ITEMS.
See Also