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

El controlador Unidrv proporciona el método IPrintOemDriverUni::DrvWriteAbortBuf para permitir que un complemento de representación de OEM enviar código de limpieza de impresoras después de que un usuario finalice un trabajo de impresión.

Sintaxis

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

Parámetros

pdevobj

Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ.

pBuffer

Puntero proporcionado por el autor de la llamada a un búfer que contiene un fragmento de código que se va a enviar a la impresora.

cbSize

Número de bytes proporcionado por el autor de la llamada en el búfer al que apunta pBuffer.

dwWait

Tiempo proporcionado por el autor de la llamada, la impresora debe esperar, en milisegundos, para poder iniciar un nuevo trabajo de impresión después de que se anule el trabajo actual.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no se implementa.

Observaciones

Los OEM usan IPrintOemDriverUni::D rvWriteSpoolBuf para enviar la salida a la impresora. Si el usuario finaliza un trabajo de impresión, IPrintOemDriverUni::DrvWriteSpoolBuf devuelve E_FAIL y ya no se puede usar para enviar datos a la impresora. Cuando esto ocurre, ciertas impresoras deben tener un fragmento de código de limpieza enviado a ellos, restableciendo sus estados antes de poder iniciar nuevos trabajos de impresión. Para estas impresoras, se usa IPrintOemDriverUni::DrvWritetAbortBuf para enviar este fragmento de código a la impresora.

IPrintOemDriverUni::DrvWriteAbortBuf solo se puede llamar después de que IPrintOemDriverUni::DrvWriteSpoolBuf haya devuelto E_FAIL. IPrintOemDriverUni::DrvWriteAbortBuf no se debe llamar a más de una vez por trabajo.

Los complementos de representación se describen en Personalizar los controladores de impresora de Microsoft.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)