Функция GdiStartDocEMF (winppi.h)

Статья
02/07/2025

Функция GdiStartDocEMF выполняет операции инициализации для задания печати в формате EMF.

Синтаксис

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

Параметры

SpoolFileHandle

Вызывающий дескриптор файла spool, полученный предыдущим вызовом GdiGetSpoolFileHandle.

pDocInfo

Вызывающий указатель на структуру DOCINFOW (описанную в документации по пакету SDK Microsoft Window).

Возвращаемое значение

Если операция выполнена успешно, функция возвращает TRUE. В противном случае функция возвращает FALSE, а код ошибки можно получить путем вызова GetLastError.

Замечания

Функция GdiStartDocEMF экспортируется gdi32.dll для использования в функции PrintDocumentOnPrintProcessor обработчика печати.

Функция выполняет инициализации, которые должны выполняться до воспроизведения записей EMF задания печати. Функция вызывает функцию startDoc spooler (описанную в документации по пакету SDK для Окон), которая, в свою очередь, вызывает функцию драйвера принтера DrvStartDoc.

Обработчик печати должен задать элемент lpszOutput структуры DOCINFOW в качестве имени выходного файла, содержащегося в структуре PRINTPROCESSOROPENDATA, ранее полученной функцией OpenPrintProcessor.

Обработчик печати должен задать lpszDocName элемент структуры DOCINFOW указателем имени документа, ранее полученным функцией PrintDocumentOnPrintProcessor.

Дополнительные сведения см. в разделе Использование функций GDI впроцессоров печати.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	winppi.h (include Winppi.h)
библиотеки	Gdi32.Lib
DLL	Gdi32.dll

См. также

GdiEndDocEMF

Поделиться через