Funzione SetupDiGetDriverInfoDetailW (setupapi.h)
La funzione SetupDiGetDriverInfoDetail recupera i dettagli delle 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 SetupDiGetDriverInfoDetailW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[in] PSP_DRVINFO_DATA_W DriverInfoData,
[in, out] PSP_DRVINFO_DETAIL_DATA_W 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 informazioni sul dispositivo che rappresenta il dispositivo per cui recuperare le informazioni sul driver. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene 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 sul driver che rappresenta il driver per cui recuperare i dettagli. Se si specifica DeviceInfoData , il driver deve essere un 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 viene specificato, 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 ID compatibile. Gli elenchi sono in formato REG_MULTI_SZ. Per informazioni sull'hardware e sugli ID compatibili, vedere Stringhe di identificazione del dispositivo.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.
Commenti
Se il membro delle informazioni sul 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 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
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 |