Funzione SetupDiGetSelectedDriverW (setupapi.h)

Articolo
11/20/2024

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 cui recuperare un driver selezionato.

[in, optional] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica un elemento di informazioni sul dispositivo che rappresenta il dispositivo in DeviceInfoSet per cui recuperare il driver selezionato. Questo parametro è facoltativo e può essere NULL. Se si specifica questo parametro, 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 SP_DRVINFO_DATA che riceve informazioni sul driver selezionato.

Valore restituito

Se 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 un driver non è stato selezionato per l'istanza del dispositivo specificata, l'errore registrato viene ERROR_NO_DRIVER_SELECTED.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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

Vedere anche

SetupDiSetSelectedDriver

Condividi tramite