gdiStartDocEMF 函数 (winppi.h)

GdiStartDocEMF 函数对 EMF 格式的打印作业执行初始化操作。

语法

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

SpoolFileHandle

调用方提供的假脱机文件句柄，由先前调用 GdiGetSpoolFileHandle 获取。

pDocInfo

调用方提供的指向 DOCINFOW 结构的指针 (Microsoft Window SDK 文档) 中所述。

如果操作成功，则函数返回 TRUE。否则，函数返回 FALSE，并且可以通过调用 GetLastError 获取错误代码。

GdiStartDocEMF 函数由 gdi32.dll 导出，以便在打印处理器的 PrintDocumentOnPrintProcessor 函数中使用。

函数执行在播放打印作业的 EMF 记录之前必须进行的初始化。函数 (Window SDK 文档) 中所述，调用后台处理程序的 StartDoc 函数，进而调用打印机驱动程序的 DrvStartDoc 函数。

打印处理器必须将 DOCINFOW 结构的 lpszOutput 成员设置为 PRINTPROCESSOROPENDATA 结构中包含的输出文件名，该名称以前由 OpenPrintProcessor 函数接收。

打印处理器必须将 DOCINFOW 结构的 lpszDocName 成员设置为文档名称指针，该指针之前由 PrintDocumentOnPrintProcessor 函数接收。