Compartir a través de


Método IPrintTicketProvider::ConvertDevModeToPrintTicket (prdrvcom.h)

El método IPrintTicketProvider::ConvertDevModeToPrintTicket convierte una estructura de DEVMODEW en un vale de impresión.

Sintaxis

HRESULT ConvertDevModeToPrintTicket(
  [in] IN ULONG            cbDevmode,
  [in] IN PDEVMODE         pDevmode,
  [in] IN IXMLDOMDocument2 *pPrintTicket
);

Parámetros

[in] cbDevmode

Tamaño, en bytes, de la estructura DEVMODEW de entrada. El tamaño incluye las partes públicas y privadas de esta estructura.

[in] pDevmode

Puntero a la estructura de DEVMODEW de entrada, incluidas sus partes públicas y privadas.

[in] pPrintTicket

Puntero al vale de impresión completado parcialmente. Cuando IPrintTicketProvider::ConvertDevModeToPrintTicket devuelve, se deben rellenar todas las entradas del vale de impresión.

Valor devuelto

IPrintTicketProvider::ConvertDevModeToPrintTicket debe devolver S_OK si la operación se realiza correctamente. De lo contrario, este método debe devolver un código de error COM estándar.

Observaciones

Cuando el sistema de impresión convierte el contenido de una estructura de DEVMODEW en un vale de impresión, convierte todos los campos públicos DEVMODEW excepto los que el proveedor de complementos ha indicado debe estar deshabilitado. Para estos deVMODEW campos que están deshabilitados y no convertidos, el proveedor del complemento es responsable de rellenar los valores de vale de impresión correspondientes. Si la instantánea DEVMODEW se deshabilitó durante una llamada a IPrintTicketProvider::BindPrinter, la representación de la conversión debe proporcionar suficiente información para reconstruir la estructura original DEVMODEW desde el vale de impresión sin pérdida de información.

La instantánea DEVMODEW permite admitir diferencias sutiles en las opciones proporcionadas en la estructura DEVMODEW para la que es posible que el vale de impresión no tenga representaciones. Por ejemplo, DEVMODEW podría admitir el tamaño del papel LETTER mientras que el vale de impresión admite el tamaño de papel LETTERSMALL.

Requisitos

Requisito Valor
encabezado de prdrvcom.h (include Prdrvcom.h)

Consulte también

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode