Método IPrintOemUni2::WritePrinter (prcomoem.h)

El IPrintOemUni2::WritePrinter método, si se admite, permite que un complemento de representación capture todos los datos de salida generados por un controlador Unidrv. Si no se admite este método, los datos de salida se enviarán al colador en una llamada a la API WritePrinter del administrador de colas (que se describe en la documentación de Microsoft Windows SDK).

Sintaxis

HRESULT WritePrinter(
  PDEVOBJ pdevobj,
  PVOID   pBuf,
  DWORD   cbBuffer,
  PDWORD  pcbWritten
);

Parámetros

pdevobj

Puntero a una estructura DEVOBJ .

pBuf

Puntero al primer byte de una matriz de bytes que contiene los datos de salida generados por el controlador Unidrv.

cbBuffer

Especifica el tamaño, en bytes, de la matriz a la que apunta pBuf.

pcbWritten

Puntero a un valor DWORD que recibe el número de bytes de datos que se enviaron correctamente al complemento.

Valor devuelto

Si se ejecuta correctamente, este método devuelve S_OK. De lo contrario, este método debe devolver un valor adecuado en el VALOR HRESULT devuelto.

Comentarios

En el momento de DrvEnablePDEV , el controlador Unidrv llama a este método con pBuf y pdevobj establecido en NULL y cbBuf establecido en 0, para detectar si el complemento implementa esta función. El complemento debe devolver S_OK para indicar que implementa este método y debe devolver E_NOTIMPL de lo contrario.

Este método debe notificar el número de bytes escritos en la función WritePrinter del administrador de colas en pcbWritten. Un valor de cero no tiene ningún significado especial; los errores se deben notificar a través del HRESULT devuelto.

El IPrintOemUni2::WritePrinter método es opcional. Si un complemento de representación implementa este método, el método IPrintOemUni::GetImplementedMethod del complemento debe devolver S_OK cuando recibe "WritePrinter" como entrada.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)