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

Artigo
02/07/2025

O método IPrintOemDriverUni::DrvWriteAbortBuf é fornecido pelo driver Unidrv para permitir que um plug-in de renderização de OEM envie o código de limpeza da impressora após um usuário encerrar 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 de 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.

Valor de retorno

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

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

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 de limpeza 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 que IPrintOemDriverUni::DrvWriteSpoolBuf retornar 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 os drivers de impressora da Microsoft.

Requisitos

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

Compartilhar via