Funzione SetupDiSetDeviceInstallParamsA (setupapi.h)
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 |