Función EngWritePrinter (winddi.h)

La función EngWritePrinter permite que los archivos DLL de gráficos de impresora envíen un flujo de datos al hardware de la impresora.

Sintaxis

ENGAPI BOOL EngWritePrinter(
  [in]  HANDLE  hPrinter,
  [in]  LPVOID  pBuf,
  [in]  DWORD   cbBuf,
  [out] LPDWORD pcWritten
);

Parámetros

[in] hPrinter

Controlador proporcionado por el autor de la llamada a la impresora. Debe ser el identificador recibido como el valor del parámetro hDriver de la función DrvEnablePDEV.

[in] pBuf

Puntero proporcionado por el autor de la llamada a un búfer que contiene una secuencia de bytes que se va a enviar a la impresora.

[in] cbBuf

Especifica el número proporcionado por el autor de la llamada de bytes contenidos en el búfer al que apunta pBuf.

[out] pcWritten

Puntero proporcionado por el autor de la llamada a una ubicación DWORD que recibe el número de bytes escritos realmente en la impresora.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve TRUE; de lo contrario, devuelve FALSE.

Comentarios

Las DLL de gráficos de impresora llaman a EngWritePrinter para enviar flujos de datos (secuencias de control o datos de imagen) al administrador de impresión, que a su vez envía los datos al hardware de la impresora llamando al monitor de impresión adecuado. La función devuelve después de que el administrador de colas reciba los datos.

El búfer al que apunta pBuf no puede estar en la memoria del usuario; es decir, pBuf no puede apuntar a la memoria asignada por EngCreateBitmap con la marca BMF_USERMEM establecida o por EngAllocUserMem.

Para obtener más información sobre cómo llamar a EngWritePrinter, vea Representación de un trabajo de impresión.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Universal
Encabezado	winddi.h (incluya Winddi.h)
Library	Win32k.lib
Archivo DLL	Win32k.sys

Consulte también

DrvEnablePDEV

EngAllocUserMem

EngCreateBitmap