IDWriteFontFace::GetFiles 方法 (dwrite.h)
取得代表字型臉部的字型檔案。
語法
HRESULT GetFiles(
[in, out] UINT32 *numberOfFiles,
[out, optional] IDWriteFontFile **fontFiles
);
參數
[in, out] numberOfFiles
類型: UINT32*
如果 fontFiles 為 Null,則會收到代表字型臉部的檔案數目。 否則,應該傳遞所要求的字型檔案數目。 如需詳細資訊,請參閱下面的一節。
[out, optional] fontFiles
類型: IDWriteFontFile**
當這個方法傳回時,會包含使用者提供的陣列指標,此陣列會儲存代表字型臉部之字型檔案的指標。 如果使用者只想要代表字型的檔案數目,這個參數可以是 Null 。 此 API 會遞增根據 COM 慣例傳回的字型檔案指標參考計數,而且用戶端應該在完成時釋出這些指標。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
IDWriteFontFace::GetFiles方法應該呼叫兩次。 第一次呼叫 GetFilesfontFiles 應該是 Null。 當方法傳回時, numberOfFiles 會收到代表字型臉部的字型檔案數目。
然後,再次呼叫 方法,傳遞輸出第一次呼叫 的 numberOfFiles 值,以及正確大小的非 Null 緩衝區,以儲存 IDWriteFontFile 指標。
需求
最低支援的用戶端 | 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | dwrite.h |
程式庫 | Dwrite.lib |
Dll | Dwrite.dll |