SetupDiGetHwProfileList

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

SetupDiCreateDevRegKey, SetupDiOpenDevRegKey