DrvEnableDriver-Funktion (winddi.h)

Artikel
03/04/2024

Die DrvEnableDriver-Funktion ist der anfängliche Treibereinstiegspunkt, der von der Treiber-DLL exportiert wird. Es füllt eine DRVENABLEDATA-Struktur mit der Grafik-DDI-Versionsnummer des Treibers und den aufrufenden Adressen aller vom Treiber unterstützten Grafik-DDI-Funktionen aus.

Syntax

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

Parameter

iEngineVersion

Gibt die Version von GDI an, die derzeit ausgeführt wird.

cj

Ist die Größe der Struktur in Bytes, auf die von pded verwiesen wird. Wenn die Struktur größer als erwartet ist, sollten zusätzliche Member unverändert bleiben.

[in] pded

Zeiger auf eine DRVENABLEDATA-Struktur . GDI initialisiert cj-Bytes null vor dem Aufruf. Der Treiber füllt seine eigenen Daten ein.

Rückgabewert

Der Rückgabewert ist TRUE , wenn der angegebene Treiber aktiviert ist. Andernfalls ist es FALSE, und ein Fehlercode wird protokolliert.

Hinweise

DrvEnableDriver muss in allen Grafiktreibern implementiert sein. Wenn Sie die WDK-Buildtools (Windows Driver Kit) verwenden und TARGETTYPE auf GDI_DRIVER festgelegt haben (siehe Erstellen einer Druckergrafik-DLL), muss diese Funktion drvEnableDriver heißen. Dies ist die einzige Anzeigetreiberfunktion, auf die über den Namen zugegriffen werden muss. Auf alle anderen Funktionen des Anzeigetreibers wird über Funktionszeiger zugegriffen. daher werden ihre Namen in dieser Dokumentation als Pseudonamen dargestellt.

Auch einmalige Initialisierungen, z. B. die Zuweisung von Semaphoren, können von dieser Funktion ausgeführt werden. Der Treiber sollte warten, bis DrvEnablePDEV aufgerufen wird, bevor Er Hardware aktiviert, z. B. eine Anzeige.

Bei der Versionsüberprüfung mit dem in iEngineVersion bereitgestellten Wert sollte der Treiber die entsprechende DDI_DRIVER_VERSION_Xxx-Konstante (definiert in winddi.h) verwenden, die in der folgenden Tabelle dargestellt ist. Treiber sollten fast nie nur auf Gleichheit überprüfen, da neue Versionen und Service Pack-Releases für das Betriebssystem in Zukunft veröffentlicht werden. Weitere Informationen finden Sie unter DRVENABLEDATA.

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