Función DrvStartDoc (winddi.h)

Artículo
08/27/2023

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).