structure SP_CLASSINSTALL_HEADER (setupapi.h)
Un SP_CLASSINSTALL_HEADER est le premier membre d’une structure de paramètres d’installation de classe. Il contient le code de demande d’installation de l’appareil qui définit le format du reste de la structure des paramètres d’installation.
Syntaxe
typedef struct _SP_CLASSINSTALL_HEADER {
DWORD cbSize;
DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;
Membres
cbSize
Taille, en octets, de la structure SP_CLASSINSTALL_HEADER.
InstallFunction
Demande d’installation de l’appareil (code DIF) pour la structure des paramètres d’installation de classe.
Les codes DIF ont le format DIF_XXX et sont définis dans Setupapi.h. Consultez Device Installation Function Codes pour obtenir une description complète des codes DIF.
Remarques
Lorsqu’un composant alloue une structure de paramètres d’installation de classe, il initialise généralement les champs d’en-tête de la structure. Un tel composant définit le membre InstallFunction sur le code DIF de la demande d’installation et définit cbSize sur la taille de la structure SP_CLASSINSTALL_HEADER. Par exemple :
SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;
Un composant doit définir le membre InstallFunction avant de transmettre une structure de paramètres d’installation de classe à SetupDiSetClassInstallParams.
Toutefois, un composant n’a pas besoin de définir ce champ lors du passage des paramètres d’installation de classe à SetupDiGetClassInstallParams. Cette fonction définit le membre InstallFunction dans la structure qu’il transmet à l’appelant. Il définit InstallFunction sur le code DIF_XXX pour la demande d’installation de l’appareil actuellement active.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | setupapi.h (inclure Setupapi.h) |