ID3DXFont：:P reloadText 方法

將格式化的文字載入視訊記憶體，以改善轉譯至裝置的效率。這個方法支援 ANSI 和 Unicode 字串。

語法

HRESULT PreloadText(
  [in] LPCTSTR *pString,
  [in] INT     Count
);

pString [in]

類型： LPCTSTR*

要載入至視訊記憶體的字元字串指標。如果編譯器設定需要 Unicode，則資料類型 LPCTSTR 會解析為 LPCWSTR;否則，資料類型會解析為 LPCSTR。請參閱＜備註＞。

計數 [in]

類型： INT

文字字串中的字元數。

如果方法成功，傳回值會S_OK。如果方法失敗，傳回值可以是下列其中一項：D3DERR_INVALIDCALL，D3DXERR_INVALIDDATA。

編譯器設定也會決定函式版本。如果已定義 Unicode，函式呼叫會解析為 PreloadTextW。否則，函式呼叫會解析為 PreloadTextA，因為正在使用 ANSI 字串。

這個方法會產生紋理，其中包含代表輸入文字的字元。圖像會繪製為一系列三角形。

文字不會轉譯至裝置;仍必須呼叫 DrawText 才能轉譯文字。不過，藉由將文字預先載入到視訊記憶體中， DrawText 將會使用較少的 CPU 資源。

此方法會在內部使用 GDI 函式 GetCharacterPlacement將字元轉換成字元。

需求	值
標頭	D3dx9core.h
程式庫	D3dx9.lib