Compartilhar via


Método IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket (prcomoem.h)

O método IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket converte uma estrutura de DEVMODEW em um tíquete de impressão.

Sintaxe

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

Parâmetros

[in] cbDevmode

O tamanho, em bytes, da estrutura de de DEVMODEW de entrada. O tamanho inclui as partes pública e privada dessa estrutura.

[in] pDevmode

Um ponteiro para a estrutura DEVMODEW de entrada.

[in] cbDrvPrivateSize

O tamanho, em bytes, da estrutura DEVMODEW privada do plug-in.

[in] pPrivateDevmode

Um ponteiro para a estrutura de DEVMODEW privada do plug-in.

[in, out] pPrintTicket

Um ponteiro para o tíquete de impressão parcialmente concluído. Quando IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket retorna, todas as entradas no tíquete de impressão devem ser preenchidas.

Valor de retorno

IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket deverá retornar S_OK se a operação for bem-sucedida. Caso contrário, esse método deve retornar um código de erro COM padrão.

Observações

O driver principal chama o método IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket com um tíquete de impressão de entrada preenchido com recursos públicos e unidrv-privados ou Pscript5-private. O plug-in é gratuito para definir deVMODEW configurações na parte pública ou na parte privada do plug-in, com base nas configurações do tíquete de impressão de entrada. Além de definir novos itens DEVMODEW, o plug-in pode modificar as configurações existentes na parte pública da estrutura DEVMODEW.

Os campos de estrutura DEVMODEW que se correlacionam com a parte da estrutura de interesse de DEVMODEW para o cliente já terão sido preenchidos antes de IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket é chamado, incluindo a parte pública da estrutura DEVMODEW e excluindo os valores definidos privadamente na parte pública da estrutura DEVMODEW.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho prcomoem.h (inclua Prcomoem.h)

Consulte também

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode