struttura SP_CLASSINSTALL_HEADER (setupapi.h)

Articolo
08/26/2023

Un SP_CLASSINSTALL_HEADER è il primo membro di qualsiasi struttura dei parametri di installazione della classe. Contiene il codice di richiesta di installazione del dispositivo che definisce il formato del resto della struttura dei parametri di installazione.

Sintassi

typedef struct _SP_CLASSINSTALL_HEADER {
  DWORD       cbSize;
  DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;

Members

cbSize

Dimensione, in byte, della struttura SP_CLASSINSTALL_HEADER.

InstallFunction

Richiesta di installazione del dispositivo (codice DIF) per la struttura dei parametri di installazione della classe.

I codici DIF hanno il formato DIF_XXX e sono definiti in Setupapi.h. Per una descrizione completa dei codici DIF, vedere Device Installation Function Codes .See Device Installation Function Codes for a complete description of DIF codes.

Commenti

Quando un componente alloca una struttura dei parametri di installazione di una classe, in genere inizializza i campi di intestazione della struttura. Tale componente imposta il membro InstallFunction sul codice DIF per la richiesta di installazione e imposta cbSize sulle dimensioni della struttura SP_CLASSINSTALL_HEADER. Ad esempio:

SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;

Un componente deve impostare il membro InstallFunction prima di passare una struttura di parametri di installazione della classe a SetupDiSetClassInstallParams.

Tuttavia, un componente non deve impostare questo campo quando si passano i parametri di installazione della classe a SetupDiGetClassInstallParams. Questa funzione imposta il membro InstallFunction nella struttura che restituisce al chiamante. Imposta InstallFunction sul codice DIF_XXX per la richiesta di installazione del dispositivo attualmente attiva.