SetupDiGetSelectedDevice function (setupapi.h)

The SetupDiGetSelectedDevice function retrieves the selected device information element in a device information set.

Syntax

WINSETUPAPI BOOL SetupDiGetSelectedDevice(
  [in]  HDEVINFO         DeviceInfoSet,
  [out] PSP_DEVINFO_DATA DeviceInfoData
);

Parameters

[in] DeviceInfoSet

A handle to the device information set for which to retrieve the selected device information element.

[out] DeviceInfoData

A pointer to an SP_DEVINFO_DATA structure that receives information about the selected device information element for DeviceInfoSet. The caller must set DeviceInfoData.cbSize to sizeof(SP_DEVINFO_DATA). If a device is currently not selected, the function fails and a call to GetLastError returns ERROR_NO_DEVICE_SELECTED.

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.

Remarks

SetupDiGetSelectedDevice is usually used by an installation wizard.

Requirements

See also

SP_DEVINFO_DATA

SetupDiSetSelectedDevice