Compartilhar via


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

O método IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket converte uma estrutura 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 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 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.

Retornar valor

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.

Comentários

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-private ou Pscript5-private. O plug-in é gratuito para definir as configurações de DEVMODEW na parte pública ou na parte privada do plug-in, com base nas configurações no 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 DEVMODEW para o cliente já terão sido preenchidos antes que IPrintOemPrintTicketProvider::ConvertDevModeToPrintTicket seja chamado, incluindo a parte pública da estrutura DEVMODEW e excluindo os valores definidos de forma privada na parte pública da estrutura DEVMODEW.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode