Funzione SetupDiGetDriverInfoDetailA (setupapi.h)
La funzione SetupDiGetDriverInfoDetail recupera informazioni sui driver per un set di informazioni sul dispositivo o un particolare elemento di 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 per un set di informazioni sul dispositivo che contiene un elemento di informazioni sul driver per il quale recuperare le informazioni sul driver.
[in, optional] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che specifica un elemento di informazioni sul dispositivo che rappresenta il dispositivo per il quale recuperare le informazioni sul driver. Questo parametro è facoltativo e può essere NULL. Se si specifica questo parametro, 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 di informazioni sul driver che rappresenta il driver per il quale recuperare i dettagli. Se si specifica DeviceInfoData, 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 si specifica questo parametro, DriverInfoDetailData. cbSize deve essere impostato sul valore di sizeof(SP_DRVINFO_DETAIL_DATA) prima di chiamare 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 che i byte aggiuntivi necessari per il buffer di caratteri a lunghezza variabile alla fine che contiene l'elenco di ID hardware e l'elenco di ID compatibili. Gli elenchi sono in formato REG_MULTI_SZ. Per informazioni sull'hardware e sugli ID compatibili, vedere stringhe di identificazione dei dispositivi .
Valore restituito
Se ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.
Osservazioni
Se il membro informazioni del driver specificato e il buffer fornito dal chiamante sono entrambi validi, questa funzione viene garantita di compilare tutti i campi statici nella struttura SP_DRVINFO_DETAIL_DATA e il maggior numero possibile di ID 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 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 |