EngGetPrinterDriver-Funktion (winddi.h)

Artikel
03/13/2024

Die EngGetPrinterDriver-Funktion ruft Treiberdaten für den angegebenen Drucker ab.

Syntax

ENGAPI BOOL EngGetPrinterDriver(
  [in]            HANDLE hPrinter,
  [in, optional]  LPWSTR pEnvironment,
  [in]            DWORD  dwLevel,
  [out, optional] BYTE   *lpbDrvInfo,
  [in]            DWORD  cbBuf,
  [out]           DWORD  *pcbNeeded
);

Parameter

[in] hPrinter

Handle mit dem Drucker, für den die Treiberdaten abgerufen werden sollen.

[in, optional] pEnvironment

Zeiger auf eine NULL-Zeichenfolge, die die Umgebung angibt. Beispielsweise gibt "Windows NT x86" ein NT-basiertes Betriebssystem an, das auf einem Intel-Prozessor ausgeführt wird. Wenn pEnvironmentNULL ist, wird die aktuelle Umgebung des aufrufenden Treibers und clientcomputers verwendet.

[in] dwLevel

Gibt die Version der Struktur an, auf die lpbDrvInfo verweist. Dieser Parameter muss einer der folgenden Werte sein:

Wert	Bedeutung
1	GDI schreibt eine DRIVER_INFO_1-Struktur in den Puffer, auf den lpbDrvInfo verweist.
2	GDI schreibt eine DRIVER_INFO_2-Struktur in den Puffer, auf den lpbDrvInfo verweist.
3	GDI schreibt eine DRIVER_INFO_3-Struktur in den Puffer, auf den lpbDrvInfo verweist.

[out, optional] lpbDrvInfo

Zeiger auf einen Puffer, in dem GDI die angeforderte DRIVER_INFO_X-Struktur platziert.

[in] cbBuf

Gibt die Größe des Puffers in Bytes an, auf den lpbDrvInfo verweist.

[out] pcbNeeded

Zeiger auf einen Speicherspeicherort, an dem GDI die Anzahl der in den Puffer kopierten Bytes platziert, auf die lpbDrvInfo beim Erfolg verweist, oder die Anzahl der erforderlichen Bytes, wenn cbBuf zu klein ist.

Rückgabewert

EngGetPrinterDriver gibt bei Erfolg TRUE zurück. Andernfalls wird ein Fehler gemeldet und FALSE zurückgegeben.

Hinweise

Eine Druckertreiber-DLL kann mit mehreren Datendateien arbeiten, um unterschiedliche Druckermodelle zu unterstützen. Der Druckertreiber ruft EngGetPrinterDriver auf, um zu bestimmen, welche Datendatei verwendet werden soll. Beispielsweise ruft der Unidrv-Renderer diese Funktion auf, um den Namen einer GPD-Datei zu bestimmen, und der Postscript-Treiber ruft diese Funktion auf, um den Namen einer PPD-Datei zu bestimmen. Die DRIVER_INFO_2- und DRIVER_INFO_3-Strukturen enthalten einen vollständigen Pfad und Dateinamen, der den Speicherort der Datendatei angibt. Der Druckertreiber kann dann den zurückgegebenen Pfad und dateinamen verwenden, um die Datendatei zu laden, indem EngLoadModule mit dem Pfad und dateinamen als einzelnes Argument aufgerufen wird.

Die DRIVER_INFO_X-Strukturen werden in der Microsoft Windows SDK-Dokumentation beschrieben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys

Weitere Informationen

EngLoadModule

Freigeben über