Funzione SetupDiGetDeviceInstallParamsW (setupapi.h)
La funzione SetupDiGetDeviceInstallParams recupera i parametri di installazione del dispositivo per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiGetDeviceInstallParamsW(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out] PSP_DEVINSTALL_PARAMS_W 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 di SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se si specifica questo parametro, SetupDiGetDeviceInstallParams recupera i parametri di installazione per il dispositivo specificato. Se questo parametro è NULL, la funzione recupera i parametri di installazione globali del dispositivo associati a DeviceInfoSet.
[out] DeviceInstallParams
Puntatore a una struttura di 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
Se ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.
Osservazioni
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 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 |
| set di API | ext-ms-win-setupapi-classinstallers-l1-1-0 (introdotto in Windows 8) |