GETINFO_GLYPHSTRING 結構 (printoem.h)
GETINFO_GLYPHSTRING 結構會作為UNIFONTOBJ_GetInfo回呼函式的輸入。
語法
typedef struct _GETINFO_GLYPHSTRING {
DWORD dwSize;
DWORD dwCount;
DWORD dwTypeIn;
PVOID pGlyphIn;
DWORD dwTypeOut;
PVOID pGlyphOut;
DWORD dwGlyphOutSize;
} GETINFO_GLYPHSTRING, *PGETINFO_GLYPHSTRING;
成員
dwSize
指定 GETINFO_GLYPHSTRING 結構的大小，以位元組為單位。 這個值是由 UNIFONTOBJ_GetInfo 呼叫端提供。
dwCount
指定 pGlyphIn 和 pGlyphOut 所指向之陣列中的元素數目。 這個值是由 UNIFONTOBJ_GetInfo 呼叫端提供。
dwTypeIn
指定 pGlyphIn 所指向的字元規範數位類型。 下列是有效值：
| 值 | 定義 |
|---|---|
| TYPE_GLYPHHANDLE | TpGlyphIn 陣列元素的類型為 HGLYPH，或裝置字型圖像的句柄。 針對 dwTypeIn 的這個值， dwTypeOut 的有效值為 TYPE_UNICODE 或 TYPE_TRANSDATA。 |
| TYPE_GLYPHID | pGlyphIn 陣列元素的類型為 DWORD，並包含所下載 TrueType 字型字元字元的字元識別碼。 針對 dwTypeIn 的這個值， dwTypeOut 的有效值為 TYPE_UNICODE 或 TYPE_GLYPHHANDLE。 |
由 UNIFONTOBJ_GetInfo 呼叫端提供。
pGlyphIn
字元規範陣列的指標。 陣列元素類型是由 dwTypeIn 表示。 這個值是由 UNIFONTOBJ_GetInfo 呼叫端提供。
dwTypeOut
指定 pGlyphOut 所指向的字元規範數位類型。 下列是有效值：
| 值 | 定義 |
|---|---|
| TYPE_GLYPHHANDLE | pGlyphOut 陣列元素的類型為 HGLYPH，或裝置字型圖像的句柄。 只有在 dwTypeIn 設定為 TYPE_GLYPHID時，這個值才有效。 |
| TYPE_TRANSDATA | pGlyphOut 陣列元素的類型為TRANSDATA。 只有在 dwTypeIn 設定為 TYPE_GLYPHHANDLE 時，這個值才有效。 |
| TYPE_UNICODE | pGlyph 陣列元素的類型為 WCHAR。 當 dwTypeIn 設定為 TYPE_GLYPHHANDLE 或 TYPE_GLYPHID 時，這個值是有效的。 |
由 UNIFONTOBJ_GetInfo 呼叫端提供。
pGlyphOut
呼叫端提供的指標，指向字元規範的空陣列。 數位會由 Unidrv 的回呼函式 UNIFONTOBJ_GetInfo 填入。 陣列元素類型是以 dwTypeOut 表示。 此指標是由呼叫端UNIFONTOBJ_GetInfo提供。
dwGlyphOutSize
指定 pGlyphOut 所指向之緩衝區的大小，以位元組為單位。 只有當 dwTypeIn 設定為 TYPE_GLYPHHANDLE 且 dwTypeOut 已設定為 TYPE_TRANSDATA 時，才會使用此成員。 如需詳細資訊，請參閱下列一節。
備註
若要將字元規範數位從某個類型轉換成另一種類型，轉譯外掛程式可以在呼叫 Unidrv 的 UNIFONTOBJ_GetInfo 回呼函式時提供GETINFO_GLYPHSTRING結構的位址。
如果轉換是從TYPE_GLYPHHANDLE轉換成TYPE_TRANSDATA，則必須呼叫 兩次UNIFONTOBJ_GetInfo 。
第一次呼叫 UNIFONTOBJ_GetInfo 之前，轉譯外掛程式會填入 dwSize、dwCount、dwTypeIn 和 pGlyphIn 成員，並將 dwGlyphOutSize 成員設定為零。
UNIFONTOBJ_GetInfo傳回之後，dwGlyphOutSize 成員會包含儲存已轉換字串所需的緩衝區大小，以位元組為單位。
外掛程式會配置 dwGlyphOutSize 成員中所接收大小的記憶體區塊、將 pGlyphOut 成員設定為指向此記憶體區塊，並再次呼叫 UNIFONTOBJ_GetInfo 。 然後 UNIDRV 會將字串從 TYPE_GLYPHHANDLE 轉換成 TYPE_TRANSDATA。
轉譯外掛程式針對 dwTypeIn和 pGlyphIn 成員指定的值通常是先前接收為 IPrintOemUni：：OutputCharStr 方法之 dwType和 pGlyph 參數的值。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | printoem.h (包含 Printoem.h) |