Funzione SetupDiGetSelectedDriverA (setupapi.h)
La funzione SetupDiGetSelectedDriver recupera il driver selezionato per un set di informazioni sul dispositivo o un particolare elemento informativo del dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiGetSelectedDriverA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DRVINFO_DATA_A DriverInfoData
);
Parametri
[in] DeviceInfoSet
Handle per il set di informazioni sul dispositivo per cui recuperare un driver selezionato.
[in, optional] DeviceInfoData
Puntatore a una struttura 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 è specificato, SetupDiGetSelectedDriver recupera il driver selezionato per il dispositivo specificato. Se questo parametro è NULL, SetupDiGetSelectedDriver recupera il driver di classe selezionato nell'elenco dei driver di classe globale associato a DeviceInfoSet.
[out] DriverInfoData
Puntatore a una struttura SP_DRVINFO_DATA che riceve informazioni sul driver selezionato.
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. Se un driver non è stato selezionato per l'istanza del dispositivo specificata, l'errore registrato è 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |