Funzione SetupDiEnumDriverInfoW (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiEnumDriverInfo enumera i membri di un elenco di driver.

Sintassi

WINSETUPAPI BOOL SetupDiEnumDriverInfoW(
  [in]           HDEVINFO           DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA   DeviceInfoData,
  [in]           DWORD              DriverType,
  [in]           DWORD              MemberIndex,
  [out]          PSP_DRVINFO_DATA_W DriverInfoData
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene l'elenco di driver da enumerare.

[in, optional] DeviceInfoData

Puntatore a una struttura di SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se si specifica questo parametro, SetupDiEnumDriverInfo enumera un elenco di driver per il dispositivo specificato. Se questo parametro è NULL, SetupDiEnumDriverInfo enumera l'elenco di driver di classe globale associato a DeviceInfoSet (questo elenco è di tipo SPDIT_CLASSDRIVER).

[in] DriverType

Tipo di elenco di driver da enumerare, che deve essere uno dei valori seguenti:

SPDIT_CLASSDRIVER

Enumerare un elenco di driver di classe. Questo tipo di elenco di driver deve essere specificato se DeviceInfoData non è specificato.

SPDIT_COMPATDRIVER

Enumerare un elenco di driver compatibili per il dispositivo specificato. Questo tipo di elenco di driver può essere specificato solo se è specificato DeviceInfoData .

[in] MemberIndex

Indice in base zero del membro informazioni driver da recuperare.

[out] DriverInfoData

Puntatore a una struttura di SP_DRVINFO_DATA inizializzata dal chiamante che riceve informazioni sul driver enumerato. Il chiamante deve impostare DriverInfoData.cbSize per sizeof(SP_DRVINFO_DATA) prima di chiamare SetupDiEnumDriverInfo. Se il membro cbSize non è impostato correttamente, SetupDiEnumDriverInfo restituirà FALSE.

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.

Osservazioni

Per enumerare i membri del set di informazioni sui driver, un programma di installazione deve prima chiamare SetupDiEnumDriverInfo con il parametro MemberIndex impostato su 0. Dovrebbe quindi incrementare MemberIndex e chiamare SetupDiEnumDriverInfo finché non sono presenti altri valori. Quando non sono presenti più valori, la funzione ha esito negativo e una chiamata a GetLastError restituisce ERROR_NO_MORE_ITEMS.

Se non si inizializza correttamente il membro cbSize della struttura di SP_DRVINFO_DATA fornita dal puntatore DriverInfoData, la funzione avrà esito negativo e registra l'errore ERROR_INVALID_USER_BUFFER.

Per compilare un elenco di driver associati a un dispositivo specifico o all'elenco di driver di classe globale per un set di informazioni sul dispositivo, usare prima SetupDiBuildDriverInfoList quindi passare tale elenco a SetupDiEnumDriverInfo.

Nota

L'intestazione setupapi.h definisce SetupDiEnumDriverInfo 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

SetupDiBuildDriverInfoList

Condividi tramite