IPrintOemUni：:D ownloadCharGlyph 方法 (prcomoem.h)

方法 IPrintOemUni::DownloadCharGlyph 可讓 Unidrv 的轉譯外掛程式將指定之軟字型的字元字元傳送至列印機。

語法

HRESULT DownloadCharGlyph(
        PDEVOBJ     pdevobj,
        PUNIFONTOBJ pUFObj,
        HGLYPH      hGlyph,
        PDWORD      pdwWidth,
  [out] OUT DWORD   *pdwResult
);

參數

pdevobj

呼叫端提供的 DEVOBJ 結構的指標。

pUFObj

呼叫端提供的 UNIFONTOBJ 結構的指標。

hGlyph

呼叫端提供的字元句柄。

pdwWidth

呼叫端提供的指標，可接收字元的方法提供寬度。

[out] pdwResult

接收方法提供的值，表示儲存字元字元所需的印表機記憶體數量，以位元組為單位。 如果作業失敗，傳回的值應該是零。

傳回值

方法必須傳回下列其中一個值。

傳回碼	描述
S_OK	作業成功。
E_FAIL	作業失敗
E_NOTIMPL	此方法尚未實作。

備註

方法 IPrintOemUni::DownloadCharGlyph 用於在不接受 PCL 命令的印表機上支援軟字型。 其目的是要讓轉譯外掛程式將字元圖像傳送至印表機。

如果轉譯外掛程式實作 IPrintOemUni::DownloadCharGlyph 方法，Unidrv 會在傳送 CmdSetCharCode 命令專案所指定的命令字串之後立即呼叫 方法，該命令字串包含在印表機的 GPD 檔案中。 (GPD 檔案會在 Microsoft 通用列印機驅動程式.) 方法中說明：此方法應該執行下列動作：

• 呼叫 UNIFONTOBJ_GetInfo 函式，以取得 hGlyph 所指定的圖像影像。
• 呼叫 IPrintOemDriverUni：:D rvWriteSpoolBuf 將圖像傳送至印表機。
• 再次呼叫 UNIFONTOBJ_GetInfo 函式以取得圖像的寬度，然後將寬度儲存在 pdwWidth 所指向的位址中。
• 將圖像放在 pdwResult 所指定的位置，以傳回儲存圖像所需的印表機記憶體數量。

方法是 IPrintOemUni::DownloadCharGlyph 選擇性的。 如果轉譯外掛程式實作這個方法，外掛程式的 IPrintOemUni：：GetImplementedMethod 方法必須在收到 “DownloadCharGlyph” 做為輸入時傳回S_OK。

如果您實作 IPrintOemUni::DownloadCharGlyph 方法，您也必須實作 IPrintOemUni：:D ownloadFontHeader 方法。

如需詳細資訊，請參閱 自定義字型管理。

規格需求

需求	值
目標平台	桌面
標頭	prcomoem.h (包含 Prcomoem.h)