DrvQueryJobAttributes-Funktion (winddiui.h)

Artikel
02/27/2024

Mit der DrvQueryJobAttributes-Funktion kann eine Druckerschnittstellen-DLL unterstützung für Funktionen wie das Drucken mehrerer Dokumentseiten auf einer physischen Seite ("N-up"-Druck), das Drucken mehrerer Kopien jeder Seite, das Sortieren von Seiten und das Drucken von Seiten in umgekehrter Reihenfolge angeben.

Syntax

BOOL DrvQueryJobAttributes(
  [in]  HANDLE   hPrinter,
  [in]  PDEVMODE pDevMode,
  [in]  DWORD    dwLevel,
  [out] LPBYTE   lpAttributeInfo
);

Parameter

[in] hPrinter

Vom Anrufer bereitgestellter Druckerhandle.

[in] pDevMode

Vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW-Struktur .

[in] dwLevel

Vom Aufrufer bereitgestellter Wert, der den Typ der Struktur angibt, auf die von lpAttributeInfo verwiesen wird, wie in der folgenden Tabelle angegeben.

dwLevel-Wert	ColumStructure, auf die von lpAttributeInfo verwiesen wird
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

Vom Aufrufer bereitgestellter Zeiger auf eine struktur, die durch dwLevel identifiziert wird.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte false zurückgegeben werden. Wenn FALSE zurückgegeben wird, wird der aktuelle Druckauftrag abgebrochen.

Hinweise

Eine Druckerschnittstellen-DLL kann optional eine DrvQueryJobAttributes-Funktion bereitstellen. Wenn die Funktion bereitgestellt wird, sollte sie die von dwLevel und plAttributeInfo beschriebene Struktur ausfüllen, um die vom Benutzer angeforderten Attribute des aktuellen Druckauftrags (z. B. N-up-Parameter und die Anzahl der Kopien) und die Fähigkeit des Treibers zur Unterstützung dieser Attribute anzugeben. Die Funktion wird in der Regel vom EMF-Druckprozessor aufgerufen, sodass sie bestimmen kann, welche Auftragsattribute vom Treiber (oder Drucker) verarbeitet werden können und welche vom Druckprozessor verarbeitet werden müssen.