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

El método IPrintTicketProvider::ConvertDevModeToPrintTicket convierte una estructura 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 DEVMODEW de entrada, incluidas sus partes públicas y privadas.

[in] pPrintTicket

Puntero al vale de impresión completado parcialmente. Cuando se devuelve IPrintTicketProvider::ConvertDevModeToPrintTicket , 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.

Comentarios

Cuando el sistema de impresión convierte el contenido de una estructura DEVMODEW en un vale de impresión, convierte todos los campos PÚBLICOS DEVMODEW excepto los que el proveedor del complemento ha indicado debe deshabilitarse. Para estos campos DEVMODEW 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 de papel LETTER mientras que el vale de impresión admite el tamaño de papel LETTERSMALL.

Requisitos

Requisito	Valor
Header	prdrvcom.h (incluya Prdrvcom.h)

Consulte también

IPrintTicketProvider

IPrintTicketProvider::ConvertPrintTicketToDevMode