Función DrvStartDoc (winddi.h)
GDI llama a la función DrvStartDoc cuando está listo para empezar a enviar un documento al controlador para su representación.
Sintaxis
BOOL DrvStartDoc(
[in] SURFOBJ *pso,
[in] LPWSTR pwszDocName,
[in] DWORD dwJobId
);
Parámetros
[in] pso
Puntero proporcionado por el autor de la llamada a una estructura SURFOBJ .
[in] pwszDocName
Puntero proporcionado por el autor de la llamada a una cadena Unicode terminada en NULL que especifica el nombre del documento que se va a imprimir.
[in] dwJobId
Número de trabajo de impresión proporcionado por el autor de la llamada. Este valor se devuelve a GDI desde el colador en una llamada a StartDocPrinter.
Valor devuelto
Si la operación se realiza correctamente, la función debe devolver TRUE. De lo contrario, debe llamar a la función SetLastError de Win32 para establecer un código de error y, a continuación, devolver FALSE.
Comentarios
Un archivo DLL de gráficos de impresora debe proporcionar una función DrvStartDoc . Normalmente, la función se usa para enviar secuencias de control al hardware de la impresora, antes de imprimir un documento, llamando a la función EngWritePrinter de GDI. La función también puede realizar operaciones de inicialización internas y específicas de documentos para el archivo DLL de gráficos de la impresora.
La función DrvStartDoc se llama al inicio de un trabajo de impresión y cada vez que una aplicación (como un procesador de impresión) llama a ResetDC (consulte DrvResetPDEV). Cuando la llamada a DrvStartDoc procede de ResetDC, el parámetro pwszDocName se establece en NULL y el parámetro dwJobId se establece en cero. Cuando la llamada procede de una aplicación, estos parámetros se establecen, respectivamente, en el nombre del documento y el número del trabajo de impresión.
Dado que no hay una llamada independiente en el archivo DLL de gráficos de la impresora cuando se inicia un trabajo de impresión, la función DrvStartDoc también debe enviar secuencias de control a la impresora para inicializar el trabajo, si es necesario por la impresora. (En otras palabras, hay un documento por trabajo).
Requisitos
| Plataforma de destino | Escritorio |
| Encabezado | winddi.h (incluya Winddi.h) |