DrvQueryJobAttributes 函式 (winddiui.h)

發行項
02/27/2024

DrvQueryJobAttributes 函式可讓印表機介面 DLL 指定支援，例如在實體頁面上列印多個文件頁面 (“N-up” 列印) 、印印每頁的多個複本、排序頁面，以及以反向順序列印頁面。

語法

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

參數

[in] hPrinter

呼叫端提供的印表機句柄。

[in] pDevMode

呼叫端提供的 DEVMODEW 結構指標。

[in] dwLevel

呼叫端提供的值，指出 lpAttributeInfo 所指向的結構類型，如下表所示。

dwLevel 值	lpAttributeInfo 所指向的 ColumStructure
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

呼叫端提供的指標，指向 dwLevel 所識別的結構。

傳回值

如果作業成功，函式應該會傳回 TRUE。否則，它應該會傳回 FALSE。傳回 FALSE 會導致目前的列印作業取消。

備註

印表機介面 DLL 可以選擇性地提供DrvQueryJobAttributes 函式。如果提供函式，它應該填入所提供的結構，由 dwLevel 和 plAttributeInfo 描述，以指出目前列印作業的使用者要求屬性 (，例如 N-up 參數和) 複本數目，以及驅動程式支援這些屬性的能力。函式通常是由 EMF 列印處理器呼叫，因此可以判斷驅動程式 (或印表機) 可以處理哪些作業屬性，以及必須由列印處理器處理哪些作業屬性。