Funzione SetupDiGetSelectedDriverA (setupapi.h)

  • Articolo

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

Vedi anche

SetupDiSetSelectedDriver