DRVENABLEDATA-Struktur (winddi.h)

Artikel
03/06/2024

Die DRVENABLEDATA-Struktur enthält einen Zeiger auf ein Array von DRVFN-Strukturen und die Grafik-DDI-Versionsnummer eines NT-basierten Betriebssystems.

Syntax

typedef struct tagDRVENABLEDATA {
  ULONG iDriverVersion;
  ULONG c;
  DRVFN *pdrvfn;
} DRVENABLEDATA, *PDRVENABLEDATA;

Member

iDriverVersion

Gibt die DDI-Grafikversionsnummer des NT-basierten Betriebssystems an, für das der Treiber bestimmt ist. Dieser Member kann auf einen der folgenden Werte festgelegt werden:

Wert	Betriebssystemversion
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Service Pack 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1

Weitere Informationen finden Sie im Abschnitt Hinweise.

c

Gibt die Anzahl der DRVFN-Strukturen im Puffer an, auf den das pdrvfn-Element verweist.

pdrvfn

Zeiger auf einen Puffer, der ein Array von DRVFN-Strukturen enthält.

Hinweise

Um unter diesen NT-basierten Betriebssystemversionen auszuführen, muss das iDriverVersion-Element wie folgt festgelegt werden:

Windows-Version	Wert von iDriverVersion
Windows NT 4.0	iDriverVersion == DDI_DRIVER_VERSION_NT4
Windows NT 4.0 SP3	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_SP3
Windows 2000	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5
Windows XP	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01
Windows XP SP1	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01_SP1

Wie in der Tabelle gezeigt, kann ein Treiber unter einer dieser Betriebssystemversionen ausgeführt werden, wenn iDriverVersion auf DDI_DRIVER_VERSION_NT4 festgelegt ist. Ein Treiber kann jedoch nur unter Windows XP und höheren Versionen des Betriebssystems ausgeführt werden, wenn iDriverVersion auf DDI_DRIVER_VERSION_NT5_01 festgelegt ist.

Hinweis Wenn ein Treiber einen DrvXxx-Grafik-DDI implementiert, der nicht in allen Versionen von Windows unterstützt wird, kann der Treiber keinen DRVFN-Eintrag für diesen Grafik-DDI angeben, wenn er unter Windows-Versionen ausgeführt wird, die ihn nicht unterstützen. Wenn der Treiber einen DRVFN-Eintrag für einen solchen Grafik-DDI angibt, lehnt Windows den Treiber ab. Im Beispiel permedia2 wird veranschaulicht, wie unterschiedliche DRVFN-Strukturen für verschiedene Versionen von Windows angegeben werden.

Anforderungen

Anforderung	Wert
Header	winddi.h (einschließlich Winddi.h)

Weitere Informationen

DRVFN

DrvEnableDriver

Share via