Función GdiStartDocEMF (winppi.h)

La función GdiStartDocEMF realiza operaciones de inicialización para un trabajo de impresión con formato EMF.

Sintaxis

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

Parámetros

SpoolFileHandle

Identificador de archivo de cola proporcionado por el autor de la llamada, obtenido por una llamada anterior a GdiGetSpoolFileHandle.

pDocInfo

Puntero proporcionado por el autor de la llamada a una estructura DOCINFOW (que se describe en la documentación del SDK de Microsoft Window).

Valor devuelto

Si la operación se realiza correctamente, la función devuelve TRUE. De lo contrario, la función devuelve FALSE y se puede obtener un código de error llamando a GetLastError.

Comentarios

La función GdiStartDocEMF se exporta mediante gdi32.dll para su uso en la función PrintDocumentOnPrintProcessor de un procesador de impresión.

La función realiza inicializaciones que deben realizarse antes de que se puedan reproducir los registros EMF de un trabajo de impresión. La función llama a la función StartDoc del administrador de trabajos (que se describe en la documentación del SDK de Windows), que a su vez llama a la función DrvStartDoc del controlador de impresora.

El procesador de impresión debe establecer el miembro lpszOutput de la estructura DOCINFOW en el nombre de archivo de salida contenido en la estructura PRINTPROCESSOROPENDATA , previamente recibida por la función OpenPrintProcessor .

El procesador de impresión debe establecer el miembro lpszDocName de la estructura DOCINFOW en el puntero de nombre del documento, recibido previamente por la función PrintDocumentOnPrintProcessor .

Para obtener más información, consulte Uso de funciones GDI en procesadores de impresión.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	winppi.h (incluir Winppi.h)
Library	Gdi32.Lib
Archivo DLL	Gdi32.dll

Consulte también

GdiEndDocEMF