Funzione SetupDiGetDriverInfoDetailA (setupapi.h)
La funzione SetupDiGetDriverInfoDetail recupera informazioni sui driver per un set di informazioni sul dispositivo o un particolare elemento informazioni sul dispositivo nel set di informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiGetDriverInfoDetailA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_A DriverInfoData,
[in, out] PSP_DRVINFO_DETAIL_DATA_A DriverInfoDetailData,
[in] DWORD DriverInfoDetailDataSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] DeviceInfoSet
Handle a un set di informazioni sul dispositivo contenente un elemento informativo driver per cui recuperare le informazioni sul driver.
[in, optional] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo che rappresenta il dispositivo per cui recuperare le informazioni sul driver. Questo parametro è facoltativo e può essere NULL. Se questo parametro è specificato, SetupDiGetDriverInfoDetail recupera informazioni su un driver in un elenco di driver per il dispositivo specificato. Se questo parametro è NULL, SetupDiGetDriverInfoDetail recupera informazioni su un driver membro dell'elenco di driver di classe globale per DeviceInfoSet.
[in] DriverInfoData
Puntatore a una struttura SP_DRVINFO_DATA che specifica l'elemento informazioni del driver che rappresenta il driver per cui recuperare i dettagli. Se deviceInfoData è specificato, il driver deve essere membro dell'elenco di driver per il dispositivo specificato da DeviceInfoData. In caso contrario, il driver deve essere membro dell'elenco di driver di classe globale per DeviceInfoSet.
[in, out] DriverInfoDetailData
Puntatore a una struttura SP_DRVINFO_DETAIL_DATA che riceve informazioni dettagliate sul driver specificato. Se questo parametro non è specificato, DriverInfoDetailDataSize deve essere zero. Se questo parametro è specificato, DriverInfoDetailData.cbSize deve essere impostato sul valore di sizeof(SP_DRVINFO_DETAIL_DATA) prima di chiama SetupDiGetDriverInfoDetail.
[in] DriverInfoDetailDataSize
Dimensioni, in byte, del buffer DriverInfoDetailData .
[out, optional] RequiredSize
Puntatore a una variabile che riceve il numero di byte necessari per archiviare le informazioni dettagliate sul driver. Questo valore include sia le dimensioni della struttura sia i byte aggiuntivi necessari per il buffer di caratteri a lunghezza variabile alla fine che contiene l'elenco ID hardware e l'elenco ID compatibile. Gli elenchi sono in formato REG_MULTI_SZ. Per informazioni sugli ID hardware e compatibili, vedere Stringhe di identificazione del dispositivo.
Valore restituito
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato eseguendo una chiamata a GetLastError.
Commenti
Se il membro informativo del driver specificato e il buffer fornito dal chiamante sono entrambi validi, questa funzione è garantita per compilare tutti i campi statici nella struttura SP_DRVINFO_DETAIL_DATA e quanti ID possibile nel buffer a lunghezza variabile alla fine mantenendo comunque REG_MULTI_SZ formato. In questo caso, la funzione restituisce FALSE e una chiamata a GetLastError restituisce ERROR_INSUFFICIENT_BUFFER. Se specificato, RequiredSize contiene il numero totale di byte necessari per la struttura con tutti gli ID.
Nota
L'intestazione setupapi.h definisce SetupDiGetDriverInfoDetail 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
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 |