Funzione SetupDiGetClassInstallParamsW (setupapi.h)

La funzione SetupDiGetClassInstallParams recupera i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiGetClassInstallParamsW(
  [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 di SP_DEVINFO_DATA che ha specificato un elemento informazioni sul dispositivo in DeviceInfoSet. Questo parametro è facoltativo e può essere NULL. Se si specifica questo parametro, 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 membro cbSize impostato su sizeof(SP_CLASSINSTALL_HEADER) sull'input o il buffer viene 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 recuperati. Se il buffer è sufficientemente grande, riceve anche la struttura dei parametri di installazione della classe specifica per il codice della funzione. Se non viene specificato ClassInstallParams, ClassInstallParamsSize deve essere 0.

[in] ClassInstallParamsSize

Dimensioni, in byte, del buffer ClassInstallParams. Se il buffer viene fornito, deve essere almeno grande quanto 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 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

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 .

Fabbisogno

Vedere anche

SetupDiSetClassInstallParams