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 呼叫的程式碼區塊放在鎖定或關鍵區段底下。

需求

另請參閱

IDWriteFontFileStream