Función DrvQueryJobAttributes (winddiui.h)

Artículo
03/05/2024

La función DrvQueryJobAttributes permite que un archivo DLL de interfaz de impresora especifique compatibilidad con tales funcionalidades, como imprimir varias páginas de documentos en una página física (impresión "N-up"), imprimir varias copias de cada página, intercalar páginas e imprimir páginas en orden inverso.

Sintaxis

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

Parámetros

[in] hPrinter

Controlador de impresora suministrado por el autor de la llamada.

[in] pDevMode

Puntero proporcionado por el autor de la llamada a una estructura DEVMODEW .

[in] dwLevel

Valor proporcionado por el autor de la llamada que indica el tipo de estructura a la que apunta lpAttributeInfo, como se indica en la tabla siguiente.

dwLevel value	ColumStructure apunta a por lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

Puntero proporcionado por el autor de la llamada a una estructura identificada por dwLevel.

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver TRUE. De lo contrario, debe devolver FALSE. Devolver FALSE hace que se cancele el trabajo de impresión actual.

Comentarios

Opcionalmente, un archivo DLL de interfaz de impresora puede proporcionar una función DrvQueryJobAttributes . Si se proporciona la función, debe rellenar la estructura proporcionada, descrita por dwLevel y plAttributeInfo, para indicar los atributos solicitados por el usuario del trabajo de impresión actual (como los parámetros N-up y el número de copias) y la capacidad del controlador para admitir esos atributos. Normalmente, el procesador de impresión EMF llama a la función , por lo que puede determinar qué atributos de trabajo pueden controlar el controlador (o la impresora) y cuál debe ser controlado por el procesador de impresión.