Funzione SetupDiGetDeviceInstallParamsA (setupapi.h)

  • Articolo

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

Sintassi

WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [out]          PSP_DEVINSTALL_PARAMS_A DeviceInstallParams
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene i parametri di installazione del dispositivo da recuperare.

[in, optional] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro è specificato, SetupDiGetDeviceInstallParams recupera i parametri di installazione per il dispositivo specificato. Se questo parametro è NULL, la funzione recupera i parametri di installazione del dispositivo globali associati a DeviceInfoSet.

[out] DeviceInstallParams

Puntatore a una struttura SP_DEVINSTALL_PARAMS che riceve i parametri di installazione del dispositivo. DeviceInstallParams. cbSize deve essere impostato sulle dimensioni, in byte, della struttura prima di chiamare questa funzione.

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

Nota

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

Requisito Valore
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

SP_DEVINFO_DATA

SP_DEVINSTALL_PARAMS

SetupDiSetDeviceInstallParams