IDWriteFactory::CreateFontFileReference 方法 (dwrite.h)
從本機字型檔案建立字型檔案參考物件。
語法
HRESULT CreateFontFileReference(
[in] WCHAR const *filePath,
[in, optional] FILETIME const *lastWriteTime,
[out] IDWriteFontFile **fontFile
);
參數
[in] filePath
類型: const WCHAR*
字元陣列,其中包含字型檔案的絕對檔案路徑。 如果使用者提供的 filePath 未對應到磁碟上的有效檔案,建構物件的後續作業可能會失敗。
[in, optional] lastWriteTime
類型: const FILETIME*
輸入檔路徑的最後一次修改時間。 如果省略 參數,函式會存取字型檔案以取得其上次寫入時間。 您應該指定此值以避免額外的磁碟存取。 如果使用者提供的 lastWriteTime 不符合磁碟上的檔案,建構物件的後續作業可能會失敗。
[out] fontFile
類型: IDWriteFontFile**
當這個方法傳回時,會包含新建立字型檔案參考物件的指標位址,或在發生失敗時為 NULL 。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 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 |