Método IPrintTicketProvider::ConvertDevModeToPrintTicket (prdrvcom.h)
O método IPrintTicketProvider::ConvertDevModeToPrintTicket converte uma estrutura DEVMODEW em um tíquete de impressão.
Sintaxe
HRESULT ConvertDevModeToPrintTicket(
[in] IN ULONG cbDevmode,
[in] IN PDEVMODE pDevmode,
[in] IN 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, incluindo suas partes públicas e privadas.
[in] pPrintTicket
Um ponteiro para o tíquete de impressão parcialmente concluído. Quando IPrintTicketProvider::ConvertDevModeToPrintTicket retornar, todas as entradas no tíquete de impressão deverão ser preenchidas.
Retornar valor
IPrintTicketProvider::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
Quando o sistema de impressão converte o conteúdo de uma estrutura DEVMODEW em um tíquete de impressão, ele converte todos os campos de DEVMODEW públicos, exceto aqueles que o provedor de plug-in indicou que devem ser desabilitados. Para esses campos DEVMODEW desabilitados e não convertidos, o provedor de plug-in é responsável por preencher os valores de tíquete de impressão correspondentes. Se o instantâneo DEVMODEW tiver sido desabilitado durante uma chamada para IPrintTicketProvider::BindPrinter, a representação da conversão deverá fornecer informações suficientes para reconstruir a estrutura DEVMODEW original do tíquete de impressão sem perda de informações.
O instantâneo DEVMODEW permite suporte para distinções sutis em opções fornecidas na estrutura DEVMODEW para as quais o tíquete de impressão pode não ter representações. Por exemplo, DEVMODEW pode dar suporte ao tamanho do papel LETTER, enquanto o tíquete de impressão dá suporte ao tamanho do papel LETTERSMALL.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | prdrvcom.h (inclua Prdrvcom.h) |