Método IPrintOemDriverUni::D rvWriteAbortBuf (prcomoem.h)

O IPrintOemDriverUni::DrvWriteAbortBuf método é fornecido pelo driver Unidrv para permitir que um plug-in de renderização OEM envie código de limpo de impressora depois que um usuário encerra um trabalho de impressão.

Sintaxe

HRESULT DrvWriteAbortBuf(
  PDEVOBJ pdevobj,
  PVOID   pBuffer,
  DWORD   cbSize,
  DWORD   dwWait
);

Parâmetros

pdevobj

Ponteiro fornecido pelo chamador para uma estrutura DEVOBJ .

pBuffer

Ponteiro fornecido pelo chamador para um buffer que contém um fragmento de código a ser enviado para a impressora.

cbSize

Número de bytes fornecido pelo chamador no buffer apontado por pBuffer.

dwWait

Período de tempo fornecido pelo chamador, a impressora deve aguardar, em milissegundos, antes de iniciar um novo trabalho de impressão após a anulação do trabalho atual.

Retornar valor

O método deve retornar um dos valores a seguir.

Código de retorno Descrição
S_OK
A operação foi realizada com êxito.
E_FAIL
Falha na operação.
E_NOTIMPL
O método não está implementado.

Comentários

Os OEMs usam IPrintOemDriverUni::D rvWriteSpoolBuf para enviar a saída para a impressora. Se um trabalho de impressão for encerrado pelo usuário, IPrintOemDriverUni::DrvWriteSpoolBuf retornará E_FAIL e não poderá mais ser usado para enviar dados para a impressora. Quando isso ocorre, determinadas impressoras devem ter um fragmento de código limpo-up enviado a elas, redefinindo seus estados antes que possam iniciar novos trabalhos de impressão. Para essas impressoras, IPrintOemDriverUni::DrvWritetAbortBuf é usado para enviar esse fragmento de código para a impressora.

IPrintOemDriverUni::DrvWriteAbortBuf só pode ser chamado depois IPrintOemDriverUni::DrvWriteSpoolBuf de ter retornado E_FAIL. IPrintOemDriverUni::DrvWriteAbortBuf não deve ser chamado mais de uma vez por trabalho.

Os plug-ins de renderização são descritos em Personalizando drivers de impressora da Microsoft.

Requisitos

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