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 记录播放之前进行的初始化。 该函数调用后台处理程序的 StartDoc 函数(在 Window SDK 文档中介绍),后者又调用打印机驱动程序的 DrvStartDoc 函数。
打印处理器必须将 DOCINFOW 结构的 lpszOutput 成员设置为 PRINTPROCESSOROPENDATA 结构中包含的输出文件名,以前由 OpenPrintProcessor 函数接收。
打印处理器必须将 DOCINFOW 结构的 lpszDocName 成员设置为文档名称指针,以前由 PrintDocumentOnPrintProcessor 函数接收。
有关详细信息,请参阅 在打印处理器中使用 GDI 函数。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | winppi.h (包括 Winppi.h) |
库 | Gdi32.Lib |
DLL | Gdi32.dll |