Funzione SetupDiGetDriverInstallParamsA (setupapi.h)

  • Articolo

La funzione SetupDiGetDriverInstallParams recupera i parametri di installazione del driver per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiGetDriverInstallParamsA(
  [in]           HDEVINFO              DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA      DeviceInfoData,
  [in]           PSP_DRVINFO_DATA_A    DriverInfoData,
  [out]          PSP_DRVINSTALL_PARAMS DriverInstallParams
);

Parametri

[in] DeviceInfoSet

Handle di un set di informazioni sul dispositivo che contiene un elemento di informazioni sul driver che rappresenta il driver per cui recuperare i parametri di installazione.

[in, optional] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che contiene un elemento informazioni sul dispositivo che rappresenta il dispositivo per il quale recuperare i parametri di installazione. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiGetDriverInstallParams recupera informazioni su un driver membro di un elenco di driver per il dispositivo specificato. Se questo parametro è NULL, SetupDiGetDriverInstallParams 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 parametri di installazione. Se DeviceInfoData viene fornito, 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.

[out] DriverInstallParams

Puntatore a una struttura SP_DRVINSTALL_PARAMS per ricevere i parametri di installazione per questo driver.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato da una chiamata a GetLastError.

Commenti

Nota

L'intestazione setupapi.h definisce SetupDiGetDriverInstallParams 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

Vedi anche

SetupDiSetDriverInstallParams