GdiStartDocEMF 函式 (winppi.h)

GdiStartDocEMF 函式會執行 EMF 格式列印作業的初始化作業。

語法

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

SpoolFileHandle

呼叫端提供的多任務緩衝處理檔句柄，由先前呼叫 GdiGetSpoolFileHandle 取得。

pDocInfo

Microsoft Window SDK 檔) 中所述的 DOCINFOW 結構 (呼叫端提供的指標。

如果作業成功，函式會傳回 TRUE。否則，函式會傳回 FALSE，而且呼叫 GetLastError 即可取得錯誤碼。

GdiStartDocEMF 函式是由 gdi32.dll 匯出，以用於列印處理器的 PrintDocumentOnPrintProcessor 函式內。

函式會執行必須在列印作業的 EMF 記錄播放之前發生的初始化。函式會呼叫多任務緩衝處理器的 StartDoc 函式 (視窗 SDK 檔) 中所述，接著會呼叫印表機驅動程式的 DrvStartDoc 函式。

列印處理器必須將 DOCINFOW 結構的 lpszOutput 成員設定為 PRINTPROCESSOROPENDATA 結構中先前由 OpenPrintProcessor 函式收到的輸出檔名。

列印處理器必須將 DOCINFOW 結構的 lpszDocName 成員設定為文件名稱指標，先前由 PrintDocumentOnPrintProcessor 函式所接收。