Método IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode (prcomoem.h)
O método IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode converte um tíquete de impressão em uma estrutura DEVMODEW .
Sintaxe
HRESULT ConvertPrintTicketToDevMode(
[in] IXMLDOMDocument2 *pPrintTicket,
[in] ULONG cbDevmode,
[in, out] PDEVMODE pDevmode,
[in] ULONG cbDrvPrivateSize,
[in] PVOID pPrivateDevmode
);
Parâmetros
[in] pPrintTicket
Um ponteiro para o tíquete de impressão de entrada.
[in] cbDevmode
O tamanho, em bytes, da estrutura DEVMODEW de entrada. Esse tamanho inclui as seções pública e privada da estrutura DEVMODEW.
[in, out] pDevmode
Um ponteiro para a estrutura DEVMODEW de entrada. Quando IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode retornar, a estrutura DEVMODEW privada do plug-in conterá informações obtidas do tíquete de impressão.
[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.
Retornar valor
IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode 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::ConvertPrintTicketToDevMode antes de executar sua parte da conversão de um tíquete de impressão em uma estrutura DEVMODEW . Na chamada para esse método, o driver principal passa um tíquete de impressão de entrada totalmente preenchido e uma estrutura DEVMODEW definida como valores padrão. Na conversão, o plug-in deve desfazer as alterações feitas no tíquete de impressão durante a conversão anterior de uma estrutura DEVMODEW em um tíquete de impressão. Se, durante essa conversão anterior, o plug-in moveu um recurso de um namespace privado para o namespace público, o plug-in deverá restaurar o recurso para o namespace privado em um formato adequado para o driver principal, ou seja, o formato no qual o driver principal havia colocado anteriormente o recurso no tíquete de impressão que foi fornecido ao plug-in no IPrintOemPrintTicketProvider:: Método ConvertDevModeToPrintTicket . Essa restauração é necessária para que o driver principal possa reconhecer o recurso no tíquete de impressão e refletir suas configurações em parte privada da estrutura DEVMODEW do driver principal enquanto o driver principal executa sua parte da conversão tíquete de impressão para DEVMODEW.
Antes que o sistema converta um tíquete de impressão de volta em uma estrutura DEVMODEW , ele primeiro carrega a estrutura DEVMODEW padrão. Em seguida, o sistema chama o método IPrintOemPrintTicketProvider::BindPrinter do provedor. Esse método deve ler todas as configurações compatíveis com o tíquete de impressão e preencher essas configurações na estrutura DEVMODEW. Observe que nem todos os recursos necessariamente serão representados e que, muitas vezes, as instâncias de opção presentes podem não conter todas as instâncias de Propriedade Pontuada que o provedor normalmente preencheria. Se o provedor fizer alterações nas configurações preenchidas pelo sistema durante a conversão do tíquete de impressão para DEVMODEW, o provedor deverá executar o inverso dessa alteração no método IPrintOemPrintTicketProvider::ConvertPrintTicketToDevMode . Depois que o provedor retorna, o sistema substitui todas as configurações de DEVMODEW públicas representadas no tíquete de impressão, mas que não são explicitamente desabilitadas pelo provedor.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | prcomoem.h (inclua Prcomoem.h) |