Funzione SetupDiSetDeviceInstallParamsA (setupapi.h)

Articolo
11/20/2024

La funzione SetupDiSetDeviceInstallParams imposta i parametri di installazione del dispositivo per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo per cui impostare i parametri di installazione del dispositivo.

[in, optional] DeviceInfoData

Puntatore a una struttura di SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere impostato su NULL. Se si specifica questo parametro, SetupDiSetDeviceInstallParams imposta i parametri di installazione per il dispositivo specificato. Se questo parametro è NULL, SetupDiSetDeviceInstallParams imposta i parametri di installazione associati all'elenco di driver di classe globale per DeviceInfoSet.

[in] DeviceInstallParams

Puntatore a una struttura SP_DEVINSTALL_PARAMS che contiene i nuovi valori dei parametri. The DeviceInstallParams. cbSize deve essere impostato sulle dimensioni, in byte, della struttura prima di chiamare questa funzione.

Valore restituito

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

Osservazioni

Tutti i parametri vengono convalidati prima che vengano apportate modifiche. Pertanto, un valore restituito di FALSE indica che non sono stati modificati parametri.

Nota

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

Vedere anche

SetupDiGetDeviceInstallParams

Condividi tramite