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

El método IPrintTicketProvider2::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 IPrintTicketProvider2::ConvertDevModeToPrintTicket , se deben rellenar todas las entradas del vale de impresión.

Valor devuelto

IPrintTicketProvider2::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 DEVMODEW públicos, excepto los que el proveedor de complementos ha indicado debe estar deshabilitado. 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 IPrintTicketProvider2::BindPrinter, la representación de la conversión debe proporcionar suficiente información para reconstruir la estructura DEVMODEW original del 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
Header	prdrvcom.h (incluya Prdrvcom.h)

Consulte también

IPrintTicketProvider2

IPrintTicketProvider2::ConvertPrintTicketToDevMode