SP_CLASSINSTALL_HEADER-Struktur (setupapi.h)
Ein SP_CLASSINSTALL_HEADER ist das erste Element einer Klasseninstallationsparameterstruktur. Sie enthält den Anforderungscode für die Geräteinstallation, der das Format der restlichen Installationsparameterstruktur definiert.
Syntax
typedef struct _SP_CLASSINSTALL_HEADER {
DWORD cbSize;
DI_FUNCTION InstallFunction;
} SP_CLASSINSTALL_HEADER, *PSP_CLASSINSTALL_HEADER;
Member
cbSize
Die Größe der SP_CLASSINSTALL_HEADER-Struktur in Bytes.
InstallFunction
Die Geräteinstallationsanforderung (DIF-Code) für die Struktur der Klasseninstallationsparameter.
DIF-Codes haben das Format DIF_XXX und sind in Setupapi.h definiert. Eine vollständige Beschreibung der DIF-Codes finden Sie unter Geräteinstallationsfunktionscodes .
Hinweise
Wenn eine Komponente eine Klasseninstallationsparameterstruktur zuordnet, initialisiert sie in der Regel die Headerfelder der -Struktur. Eine solche Komponente legt den InstallFunction-Member auf den DIF-Code für die Installationsanforderung und cbSize auf die Größe der SP_CLASSINSTALL_HEADER-Struktur fest. Beispiel:
SP_REMOVEDEVICE_PARAMS RemoveDeviceParams;
RemoveDeviceParams.ClassInstallHeader.cbSize = sizeof(SP_CLASSINSTALL_HEADER);
RemoveDeviceParams.ClassInstallHeader.InstallFunction = DIF_REMOVE;
Eine Komponente muss das InstallFunction-Element festlegen, bevor eine Klasseninstallationsparameterstruktur an SetupDiSetClassInstallParams übergeben wird.
Eine Komponente muss dieses Feld jedoch nicht festlegen, wenn Klasseninstallationsparameter an SetupDiGetClassInstallParams übergeben werden. Diese Funktion legt den InstallFunction-Member in der Struktur fest, die an den Aufrufer zurückübergibt. Sie legt InstallFunction auf den DIF_XXX-Code für die aktuell aktive Geräteinstallationsanforderung fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | setupapi.h (schließen Sie Setupapi.h ein) |