Funzione SetupDiGetClassInstallParamsA (setupapi.h)
La funzione SetupDiGetClassInstallParams recupera i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento informazioni sul dispositivo.
Sintassi
WINSETUPAPI BOOL SetupDiGetClassInstallParamsA(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData,
[out, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
[in] DWORD ClassInstallParamsSize,
[out, optional] PDWORD RequiredSize
);
Parametri
[in] DeviceInfoSet
Handle per un set di informazioni sul dispositivo che contiene i parametri di installazione della classe da recuperare.
[in, optional] DeviceInfoData
Puntatore a una struttura SP_DEVINFO_DATA che ha specificato un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiGetClassInstallParams recupera i parametri di installazione della classe per il dispositivo specificato. Se questo parametro è NULL, SetupDiGetClassInstallParams recupera i parametri di installazione della classe per l'elenco di driver di classe globale associato a DeviceInfoSet.
[out, optional] ClassInstallParams
Puntatore a un buffer contenente una struttura SP_CLASSINSTALL_HEADER . Questa struttura deve avere il membro cbSize impostato su sizeof(SP_CLASSINSTALL_HEADER) nell'input oppure il buffer è considerato non valido. Nell'output, il membro InstallFunction viene compilato con il codice della funzione di installazione del dispositivo per i parametri di installazione della classe da recuperare. Se il buffer è sufficientemente grande, riceve anche la struttura dei parametri di installazione della classe specifica per il codice della funzione. Se ClassInstallParams non è specificato, ClassInstallParamsSize deve essere 0.
[in] ClassInstallParamsSize
Dimensioni, in byte, del buffer ClassInstallParams . Se il buffer viene fornito, deve essere di dimensioni pari almeno a quello di sizeof(SP_CLASSINSTALL_HEADER). Se il buffer non viene fornito, ClassInstallParamsSize deve essere 0.
[out, optional] RequiredSize
Puntatore a una variabile di tipo DWORD che riceve il numero di byte necessari per archiviare i parametri di installazione della classe. Questo parametro è facoltativo e può essere NULL.
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
I parametri di installazione della classe sono specifici di un particolare codice della funzione di installazione del dispositivo archiviato nel campo ClassInstallHeader che si trova all'inizio del buffer ClassInstallParams .
Nota
L'intestazione setupapi.h definisce SetupDiGetClassInstallParams 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 |