Función DevQueryPrintEx (winddiui.h)

La función DevQueryPrintEx de una interfaz de impresora determina si un trabajo de impresión especificado es compatible con la configuración actual de la impresora y, por tanto, se puede imprimir.

Sintaxis

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

Parámetros

[in, out] pDQPInfo

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

Valor devuelto

Si se puede imprimir el trabajo de impresión, la función debe devolver TRUE; de lo contrario, debe devolver FALSE.

Comentarios

Los archivos DLL de la interfaz de impresora deben definir una función DevQueryPrintEx . El administrador de impresión llama a la función si la opción Mantener documentos no coincidendo está activada en la página Avanzadas de la hoja de propiedades de la impresora. Si la función devuelve TRUE, el colador pone en cola el trabajo de impresión para imprimir. De lo contrario, el trabajo se mantiene, suponiendo que la impresora se volverá a configurar para que el trabajo pueda imprimirse.

La estructura DEVQUERYPRINT_INFO recibida apunta a una estructura DEVMODEW que describe las características de la impresora requeridas por el trabajo de impresión. La función DevQueryPrintEx debe comprobar primero que los miembros de tamaño y versión de la estructura DEVMODEW recibida son compatibles con el controlador. A continuación, debe determinar si el contenido de DEVMODEW proporcionado es compatible con la configuración de impresora actual.

Si se puede imprimir el trabajo, la función solo debe devolver TRUE. Si el trabajo se debe mantener hasta más adelante, la función debe devolver FALSE después de proporcionar una cadena de texto que se pueda mostrar (en el búfer al que apunta el miembro pszErrorStr de la estructura DEVQUERYPRINT_INFO) que describe el motivo por el que no se puede imprimir el trabajo.

Las cadenas de texto que se muestran deben definirse como recursos de cadena en un archivo de recursos.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	winddiui.h (incluya Winddiui.h)
Library	Winspool.lib
Archivo DLL	WinSpool.drv