Durch Druckergrafik-DLLs definierte Funktionen
Wichtig
Es wird empfohlen, den IPP-Posteingangsklassentreiber von Microsoft zusammen mit Druckunterstützungs-Apps (PSA) zu verwenden, um die Druckoberfläche in Windows 10 und 11 für die Druckergeräteentwicklung anzupassen.
Weitere Informationen finden Sie im Designhandbuch für Druckunterstützungs-Apps.
Wie alle Grafiktreiber sind druckergrafik-DLLs für die Definition der folgenden Grafik-DDI-Funktionen verantwortlich. Nach DrvEnableDriver, dem ersten Einstiegspunkt des Treibers, werden die restlichen Funktionen in alphabetischer Reihenfolge aufgeführt. Beachten Sie, dass der Name fett angezeigt wird, da GDI DrvEnableDriver als Namen aufruft. GDI ruft alle anderen Anzeigetreiberfunktionen über ein Array von Funktionszeigern auf, das DrvEnableDriver zurückgibt.
| Funktionsname | BESCHREIBUNG |
|---|---|
| DrvEnableDriver | Ermöglicht es dem Treiber, sich selbst zu initialisieren und Zeiger auf unterstützte Grafik-DDI-Funktionen zurückzugeben. |
| DrvCompletePDEV | Stellt dem Treiber ein GDI-Handle für ein Gerät instance bereit. |
| DrvDisableDriver | (Optional) Ermöglicht dem Treiber, Bereinigungsvorgänge durchzuführen, bevor er entladen wird. |
| DrvDisablePDEV | Ermöglicht dem Treiber das Entfernen instance spezifischer Geräteinformationen. |
| DrvDisableSurface | Ermöglicht dem Treiber das Entfernen einer Zeichnungsoberfläche. |
| DrvEnablePDEV | Ermöglicht dem Treiber, GDI physische Geräteeigenschaften bereitzustellen und gerätespezifische instance zu initialisieren. |
| DrvEnableSurface | Ermöglicht dem Treiber das Erstellen einer Zeichnungsoberfläche. |
| DrvQueryDeviceSupport | (Optional) Gibt angeforderte gerätespezifische Informationen zurück. |
| DrvQueryDriverInfo | (Optional) Gibt angeforderte treiberspezifische Informationen zurück. |
Druckergrafik-DLLs sind auch für die Definition der folgenden druckspezifischen Grafik-DDI-Funktionen verantwortlich, die an bestimmten Stellen beim Rendern eines Druckauftrags aufgerufen werden.
| Funktion | Wenn aufgerufen |
|---|---|
| DrvEndDoc | Wenn GDI das Senden eines Dokuments zum Rendern an den Treiber abgeschlossen hat. |
| DrvNextBand | (Optional) Wenn GDI das Zeichnen eines Bandes für eine physische Seite abgeschlossen hat, kann der Treiber das Band an den Drucker senden. |
| DrvQueryPerBandInfo | (Optional) Bevor GDI mit dem Zeichnen eines Bandes für eine physische Seite beginnt, kann der Treiber GDI bandspezifische Informationen bereitstellen. |
| DrvSendPage | Wenn GDI das Zeichnen einer physischen Seite abgeschlossen hat, kann der Treiber die Seite an den Drucker senden. |
| DrvStartBanding | (Optional) Wenn GDI bereit ist, Bänder einer physischen Seite zum Rendern an den Treiber zu senden. |
| DrvStartDoc | Wenn GDI bereit ist, ein Dokument zum Rendern an den Treiber zu senden. |
| DrvStartPage | Wenn GDI bereit ist, eine Dokumentseite zum Rendern an den Treiber zu senden. |
In der Regel definiert eine Druckergrafik-DLL auch die zusätzlichen Grafik-DDI-Funktionen, die zum Rendern von Druckaufträgen erforderlich sind. Anzahl und Typ der definierten Funktionen sind abhängig von:
Gibt an, ob der Treiber die Verwendung von von GDI verwalteten oder geräteseitig verwalteten Zeichnungsoberflächen (oder beides) unterstützt. Weitere Informationen finden Sie unter Surface-Typen.
Der Umfang, in dem Zeichnungsvorgänge von GDI verarbeitet werden können, anstatt vom Treiber selbst ausgeführt zu werden. Weitere Informationen finden Sie unter Verwenden des Grafik-DDI.
Alle durch Druckergrafik-DLLs definierten Funktionen werden von der Kernelmodus-Grafikrendering-Engine (GRE) von GDI aufgerufen.
Die Funktionen DrvEnableDriver und DrvQueryDriverInfo werden von der Grafik-DLL exportiert. Die Adressen aller anderen unterstützten Grafik-DDI-Funktionen werden in einer Tabelle platziert, die von der DrvEnableDriver-Funktion zurückgegeben wird.