Funzione SetupDiGetSelectedDriverW (setupapi.h)
La funzione SetupDiGetSelectedDriver recupera il driver selezionato per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiGetSelectedDriverW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DRVINFO_DATA_W DriverInfoData
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo per il quale recuperare un driver selezionato.
[in, optional] DeviceInfoData
Puntatore a una struttura di SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo che rappresenta il dispositivo in DeviceInfoSet per cui recuperare il driver selezionato. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiGetSelectedDriver recupera il driver selezionato per il dispositivo specificato. Se questo parametro è NULL, SetupDiGetSelectedDriver recupera il driver di classe selezionato nell'elenco di driver di classe globale associato a DeviceInfoSet.
[out] DriverInfoData
Puntatore a una struttura di SP_DRVINFO_DATA che riceve informazioni sul driver selezionato.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato con una chiamata a GetLastError. Se non è stato selezionato un driver per l'istanza del dispositivo specificata, l'errore registrato viene ERROR_NO_DRIVER_SELECTED.
Commenti
Nota
L'intestazione setupapi.h definisce SetupDiGetSelectedDriver come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |