Função DrvQueryJobAttributes (winddiui.h)

Artigo
02/27/2024

A função DrvQueryJobAttributes permite que uma DLL de interface de impressora especifique suporte para recursos como imprimir várias páginas de documentos em uma página física (impressão "N-up"), imprimir várias cópias de cada página, agrupar páginas e imprimir páginas em ordem inversa.

Sintaxe

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

Parâmetros

[in] hPrinter

Identificador de impressora fornecido pelo chamador.

[in] pDevMode

Ponteiro fornecido pelo chamador para uma estrutura DEVMODEW .

[in] dwLevel

Valor fornecido pelo chamador que indica o tipo de estrutura apontada por lpAttributeInfo, conforme indicado na tabela a seguir.

valor dwLevel	ColumStructure apontado por lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

Ponteiro fornecido pelo chamador para uma estrutura identificada por dwLevel.

Retornar valor

Se a operação for bem-sucedida, a função deverá retornar TRUE. Caso contrário, ele deverá retornar FALSE. Retornar FALSE faz com que o trabalho de impressão atual seja cancelado.

Comentários

Opcionalmente, uma DLL de interface de impressora pode fornecer uma função DrvQueryJobAttributes . Se a função for fornecida, ela deverá preencher a estrutura fornecida, descrita por dwLevel e plAttributeInfo, para indicar os atributos solicitados pelo usuário do trabalho de impressão atual (como parâmetros N-up e o número de cópias) e a capacidade do driver de dar suporte a esses atributos. A função normalmente é chamada pelo processador de impressão EMF, portanto, pode determinar quais atributos de trabalho podem ser manipulados pelo driver (ou impressora) e que devem ser manipulados pelo processador de impressão.