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 |