PFNGETINFO 回呼函式 (printoem.h)
UNIFONTOBJ_GetInfo回呼函式是由 Unidrv 驅動程式提供,讓轉譯外掛程式可以取得字型或圖像資訊。
語法
PFNGETINFO Pfngetinfo;
BOOL Pfngetinfo(
_UNIFONTOBJ *unnamedParam1,
DWORD unnamedParam2,
PVOID unnamedParam3,
DWORD unnamedParam4,
PDWORD unnamedParam5
)
{...}
參數
unnamedParam1
函式所收到的 UNIFONTOBJ 結構的指標,該函式會進行 回呼以UNIFONTOBJ_GetInfo。 由呼叫端提供。
unnamedParam2
指定 pData 所指向之緩衝區的大小,以位元組為單位。 由呼叫端提供。
unnamedParam3
結構指標,如下表所示。 由呼叫端提供。
dwInfoID 值 | pData 結構 |
---|---|
UFO_GETINFO_FONTOBJ | GETINFO_FONTOBJ |
UFO_GETINFO_GLYPHBITMAP | GETINFO_GLYPHBITMAP |
UFO_GETINFO_GLYPHSTRING | GETINFO_GLYPHSTRING |
UFO_GETINFO_GLYPHWIDTH | GETINFO_GLYPHWIDTH |
UFO_GETINFO_MEMORY | GETINFO_MEMORY |
UFO_GETINFO_STDVARIABLE | GETINFO_STDVAR |
如需詳細資訊,請參閱一節中的表格。
unnamedParam4
指定 pData 所指向的結構類型。 由呼叫端提供。 如需詳細資訊,請參閱一節中的表格。
unnamedParam5
接收最小緩衝區大小之位置的指標,以位元組為單位,包含 dwInfoID 所識別的結構。 由呼叫端提供。
傳回值
傳回 BOOL 值。 如果作業成功,函式會傳回 TRUE。 否則會傳回 FALSE。
備註
UNIFONTOBJ_GetInfo回呼函式可讓轉譯外掛程式回呼 Unidrv,以從 GDI 取得字型或圖像資訊,以處理自定義字型管理作業所需的字型或字元資訊。
轉譯外掛程式會在傳遞至字型自定義方法的 UNIFONTOBJ 結構中接收UNIFONTOBJ_GetInfo函式的位址。
函式傳回的信息類型取決於輸入自變數。 呼叫端會提供 dwInfoID、pData 和 dwDataSize 的值,以指出所需的信息類型。 下表摘要說明傳回的信息類型。 如需詳細資訊,請參閱 結構描述。
pData 結構 | 傳回的資訊 |
---|---|
GETINFO_FONTOBJ | 描述目前字型的 FONTOBJ 結構。 |
GETINFO_GLYPHBITMAP | 單一圖像點陣圖。 |
GETINFO_GLYPHSTRING | 指定格式的字元規範數位。 |
GETINFO_GLYPHWIDTH | 一組圖像的總寬度。 |
GETINFO_MEMORY | 剩餘的可用印表機記憶體數量。 |
GETINFO_STDVAR | 一或多個 Unidrv 標準變數的目前值。 |
如果 pData 和 dwDataSize 所描述的緩衝區太小而無法接收 dwInfoID 所指示的結構,則函式會將所需的緩衝區大小載入 至由htmlNeed 所指向的位置,並傳回 FALSE。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | printoem.h (包含 Printoem.h) |