IDWriteFontFileStream::ReadFileFragment 方法 (dwrite.h)
從字型檔案讀取片段。
語法
HRESULT ReadFileFragment(
[out] void const **fragmentStart,
UINT64 fileOffset,
UINT64 fragmentSize,
[out] void **fragmentContext
);
參數
[out] fragmentStart
類型: const void**
當這個方法傳回時,會包含字型檔案片段開頭的指標位址。 這個參數會以未初始化的狀態傳遞。
fileOffset
類型: UINT64
字型檔案開頭的片段位移,以位元組為單位。
fragmentSize
類型: UINT64
檔案片段的大小,以位元組為單位。
[out] fragmentContext
類型: void**
當這個方法傳回時,會包含要傳遞至 ReleaseFileFragment之用戶端定義內容的指標之指標位址。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
請注意, ReadFileFragment 實作 必須檢查要求的字型檔案片段是否在檔案界限內。 否則,應該從 ReadFileFragment 傳回錯誤。
DirectWrite可能會同時從多個執行緒叫用相同物件上的IDWriteFontFileStream方法。 因此,依賴內部可變狀態的 ReadFileFragment 實作 必須跨多個執行緒序列化對這類狀態的存取。 例如,使用個別 Seek 和 Read 作業來讀取檔案片段的實作,必須將包含 Seek 和 Read 呼叫的程式碼區塊放在鎖定或關鍵區段底下。
需求
最低支援的用戶端 | 適用于 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 |