IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket method

The IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket method converts a DEVMODEW structure into a print ticket.

Syntax


HRESULT ConvertDevModeToPrintTicket(
  [in]       ULONG cbDevmode,
  [in]       PDEVMODE pDevmode,
  [in]       ULONG cbDrvPrivateSize,
  [in]       PVOID pPrivateDevmode,
  [in, out]  IXMLDOMDocument2 *pPrintTicket
);

Parameters

cbDevmode [in]

The size, in bytes, of the input DEVMODEW structure. The size includes both the public and private portions of this structure.

pDevmode [in]

A pointer to the input DEVMODEW structure.

cbDrvPrivateSize [in]

The size, in bytes, of the plug-in's private DEVMODEW structure.

pPrivateDevmode [in]

A pointer to the plug-in's private DEVMODEW structure.

pPrintTicket [in, out]

A pointer to the partially-completed print ticket. When IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket returns, all of the entries in the print ticket should be filled in.

Return value

IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket should return S_OK if the operation succeeds. Otherwise, this method should return a standard COM error code.

Remarks

The core driver calls the IPrintTicketProvider::ConvertDevModeToPrintTicket method with an input print ticket that is populated with public and Unidrv-private or Pscript5-private features. The plug-in is free to set DEVMODEW settings in the public part or in the plug-in's private part, based on settings in the input print ticket. In addition to setting new DEVMODEW items, the plug-in can modify existing settings in the public portion of the DEVMODEW structure.

The DEVMODEW structure fields that correlate with the part of the DEVMODEW structure of interest to the client will already have been populated before IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket is called, including the public portion of the DEVMODEW structure and excluding the privately-defined values in the public portion of the DEVMODEW structure.

Requirements

Header

Prcomoem.h (include Prcomoem.h)

See also

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft