SP_CLASSINSTALL_HEADER-Struktur (setupapi.h)

Artikel
03/04/2024

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.