DevQueryPrintEx-Funktion (winddiui.h)

Die DevQueryPrintEx--Funktion einer Druckerschnittstellen-DLL bestimmt, ob ein angegebener Druckauftrag mit der aktuellen Konfiguration des Druckers kompatibel ist und daher gedruckt werden kann.

Syntax

BOOL DevQueryPrintEx(
  [in, out] PDEVQUERYPRINT_INFO pDQPInfo
);

Parameter

[in, out] pDQPInfo

Vom Aufrufer bereitgestellter Zeiger auf eine DEVQUERYPRINT_INFO-Struktur.

Rückgabewert

Wenn der Druckauftrag gedruckt werden kann, sollte die Funktion TRUE-zurückgeben; andernfalls sollte FALSE-zurückgegeben werden.

Bemerkungen

Druckerschnittstellen-DLLs müssen eine DevQueryPrintEx--Funktion definieren. Die Funktion wird vom Druckspooler aufgerufen, wenn die Option Nicht übereinstimmende Dokumente auf der Seite Erweiterten des Eigenschaftenblatts des Druckers aktiviert ist. Wenn die Funktion TRUEzurückgibt, wird der Druckauftrag vom Spooler zum Drucken in die Warteschlange gestellt. Andernfalls wird der Auftrag gehalten, unter der Annahme, dass der Drucker schließlich neu konfiguriert wird, damit der Auftrag gedruckt werden kann.

Die empfangene DEVQUERYPRINT_INFO Struktur verweist auf eine DEVMODEW- Struktur, die die für den Druckauftrag erforderlichen Druckereigenschaften beschreibt. Die DevQueryPrintEx--Funktion sollte zuerst überprüfen, ob die Größe und Die Versionsmitglieder der empfangenen DEVMODEW-Struktur mit dem Treiber kompatibel sind. Anschließend sollte ermittelt werden, ob der bereitgestellte DEVMODEW-Inhalt mit der aktuellen Druckerkonfiguration kompatibel ist.

Wenn der Auftrag gedruckt werden kann, sollte die Funktion nur TRUEzurückgeben. Wenn der Auftrag bis zu einem späteren Zeitpunkt gehalten werden soll, sollte die Funktion FALSE- zurückgeben, nachdem eine angezeigte Textzeichenfolge bereitgestellt wurde (im Puffer, auf den die DEVQUERYPRINT_INFO Struktur pszErrorStr Member verweist), der den Grund beschreibt, warum der Auftrag nicht gedruckt werden kann.

Anzeigefähige Textzeichenfolgen sollten als Zeichenfolgenressourcen in einer Ressourcendatei definiert werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	winddiui.h (include Winddiui.h)
Library	Winspool.lib
DLL-	WinSpool.drv