Funzione SetupDiEnumDriverInfoA (setupapi.h)
La funzione SetupDiEnumDriverInfo enumera i membri di un elenco di driver.
Sintassi
WINSETUPAPI BOOL SetupDiEnumDriverInfoA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD DriverType,
[in] DWORD MemberIndex,
[out] PSP_DRVINFO_DATA_A 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 SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, 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 anche DeviceInfoData .
[in] MemberIndex
Indice in base zero del membro informazioni driver da recuperare.
[out] DriverInfoData
Puntatore a una struttura SP_DRVINFO_DATA inizializzata dal chiamante che riceve informazioni sul driver enumerato. Il chiamante deve impostare DriverInfoData.cbSize a sizeof(SP_DRVINFO_DATA) prima di chiamare SetupDiEnumDriverInfo. Se il membro cbSize non è impostato correttamente, SetupDiEnumDriverInfo restituirà FALSE.
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.
Commenti
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. Deve quindi incrementare MemberIndex e chiamare SetupDiEnumDriverInfo fino a quando 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 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 e 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 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
| 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 |