Condividi tramite


Funzione SetupDiSetClassInstallParamsA (setupapi.h)

La funzione SetupDiSetClassInstallParams imposta 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 il quale 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 che contiene 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 di informazioni o l'elemento del 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 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.

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.

Nota

L'intestazione setupapi.h definisce SetupDiSetClassInstallParams 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

   
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

Vedi anche

SetupDiGetClassInstallParams

SetupDiSetDeviceInstallParams