Funzione SetupDiSetClassInstallParamsA (setupapi.h)

Il SetupDiSetClassInstallParams set di funzioni o cancella i parametri di installazione della classe per un set di informazioni sul dispositivo o un particolare elemento di informazioni sul dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiSetClassInstallParamsA(
  [in]           HDEVINFO                DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA        DeviceInfoData,
  [in, optional] PSP_CLASSINSTALL_HEADER ClassInstallParams,
  [in]           DWORD                   ClassInstallParamsSize
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo per cui impostare i parametri di installazione della classe.

[in, optional] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che rappresenta il dispositivo per cui impostare i parametri di installazione della classe. Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiSetClassInstallParams imposta i parametri di installazione della classe per il dispositivo specificato. Se questo parametro è NULL, SetupDiSetClassInstallParams imposta i parametri di installazione della classe associati a DeviceInfoSet.

[in, optional] ClassInstallParams

Puntatore a un buffer contenente i nuovi parametri di installazione della classe da usare. La struttura SP_CLASSINSTALL_HEADER all'inizio di questo buffer deve avere il campo cbSize impostato su sizeof(SP_CLASSINSTALL_HEADER) e il campo InstallFunction deve essere impostato sul codice DI_FUNCTION che riflette il tipo di parametri contenuti nel resto del buffer.

Se classInstallParams non viene specificato, i parametri di installazione della classe corrente, se presenti, vengono cancellati per il set o l'elemento di informazioni sul dispositivo specificato.

[in] ClassInstallParamsSize

Dimensioni, in byte, del buffer ClassInstallParams. Se il buffer non viene fornito , ovvero i parametri di installazione della classe vengono cancellati, ClassInstallParamsSize deve essere 0.

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

Tutti i parametri vengono convalidati prima che vengano apportate modifiche. Pertanto, un valore restituito di FALSE indica che non sono stati modificati parametri.

Un effetto collaterale dell'impostazione dei parametri di installazione della classe è che è impostato il flag DI_CLASSINSTALLPARAMS. Se il chiamante vuole impostare i parametri, ma disabilitarne l'uso, questo flag deve essere cancellato da una chiamata a SetupDiSetDeviceInstallParams.

Se i parametri di installazione della classe vengono cancellati, il flag DI_CLASSINSTALLPARAMS viene reimpostato.

Fabbisogno

Vedere anche

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams