Funzione SetupDiSetDeviceInstallParamsA (setupapi.h)

  • Articolo

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 SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere impostato su NULL. Se questo parametro viene specificato, 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. DeviceInstallParams.CbSize deve essere impostato sulle dimensioni, in byte, della struttura prima che venga chiamata questa funzione.

Valore restituito

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

Commenti

Tutti i parametri vengono convalidati prima che vengano apportate modifiche. Pertanto, un valore restituito 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 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

SetupDiGetDeviceInstallParams