Funzione SetupDiGetDriverInfoDetailA (setupapi.h)

Articolo
03/15/2023

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.

NotaDriverInfoDetailData.cbSize non deve essere impostato sul valore del parametro DriverInfoDetailDataSize.

[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

Vedi anche

SetupDiEnumDriverInfo

SetupDiGetSelectedDriver

Condividi tramite