ID3DX10Font：:P reloadText 方法
將格式化的文字載入視訊記憶體，以改善轉譯到裝置的效率。 這個方法支援 ANSI 和 Unicode 字串。
語法
HRESULT PreloadText(
[in] LPCSTR pString,
[in] INT Count
);
參數
-
pString [in]
-
類型： LPCSTR
要載入至視訊記憶體之字元字串的指標。 如果編譯器設定需要 Unicode，則資料類型 LPCTSTR 會解析為 LPCWSTR;否則，資料類型會解析為 LPCSTR。 請參閱＜備註＞。
-
計數 [in]
-
類型： INT
文字字串中的字元數。
傳回值
類型： HRESULT
如果方法成功，傳回值會S_OK。 如果方法失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL，D3DXERR_INVALIDDATA。
備註
編譯器設定也會決定函式版本。 如果已定義 Unicode，函式呼叫會解析為 PreloadTextW。 否則，函式呼叫會解析為 PreloadTextA，因為正在使用 ANSI 字串。
這個方法會產生紋理，其中包含代表輸入文字的字元。 圖像會繪製為一系列三角形。
文字不會轉譯至裝置;ID3DX10Font：:D rawText 仍必須呼叫才能轉譯文字。 不過，藉由將文字預先載入影片記憶體中，ID3DX10Font：:D rawText 將會使用大幅減少的 CPU 資源。
此方法會在內部使用 GDI 函式 GetCharacterPlacement將字元轉換成字元。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱