BOOLEAN
SetupDiGetHwProfileList
OUT PDWORD HwProfileList,
IN DWORD HwProfileListSize,
OUT PDWORD RequiredSize,
OUT PDWORD CurrentlyActiveIndex /* optional */
);
SetupDiGetHwProfileList retrieves a list of all currently defined hardware profile IDs.
Parameters
HwProfileList
Supplies a pointer to an array to receive the list of currently defined hardware profile IDs.
HwProfileListSize
Supplies the size, in bytes, of the HwProfileList buffer.
RequiredSize
Supplies a pointer to a variable that receives the number of hardware profiles currently defined. If the number is larger than HwProfileListSize, the list is truncated to fit the array size. The value returned in RequiredSize indicates the array size required to store the entire list of hardware profiles. In this case, the function fails and a call to GetLastError returns ERROR_INSUFFICIENT_BUFFER.
CurrentlyActiveIndex
Supplies a pointer to a variable that receives the index within the returned HwProfileList of the currently active hardware profile.
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