Funzione SetupDiGetSelectedDevice (setupapi.h)

La funzione SetupDiGetSelectedDevice recupera l'elemento informazioni del dispositivo selezionato in un set di informazioni sul dispositivo.

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo per cui recuperare l'elemento informazioni del dispositivo selezionato.

[out] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che riceve informazioni sull'elemento informazioni sul dispositivo selezionato per DeviceInfoSet. Il chiamante deve impostare DeviceInfoData.cbSize a sizeof(SP_DEVINFO_DATA). Se un dispositivo non è attualmente selezionato, la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_NO_DEVICE_SELECTED.

Valore restituito

La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError.

Commenti

SetupDiGetSelectedDevice viene in genere usato da un'installazione guidata.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione setupapi.h (includere Setupapi.h)
Libreria Setupapi.lib
DLL Setupapi.dll

Vedi anche

SP_DEVINFO_DATA

SetupDiSetSelectedDevice