IDWriteFontFileStream::ReadFileFragment-Methode (dwrite.h)

Liest ein Fragment aus einer Schriftartdatei.

Syntax

HRESULT ReadFileFragment(
  [out] void const **fragmentStart,
        UINT64     fileOffset,
        UINT64     fragmentSize,
  [out] void       **fragmentContext
);

Parameter

[out] fragmentStart

Typ: const void**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf den Anfang des Schriftartdateifragments. Dieser Parameter wird nicht initialisiert übergeben.

fileOffset

Typ: UINT64

Der Offset des Fragments in Bytes vom Anfang der Schriftartdatei.

fragmentSize

Typ: UINT64

Die Größe des Dateifragments in Bytes.

[out] fragmentContext

Typ: void**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf einen Zeiger auf den clientdefinierten Kontext, der an ReleaseFileFragment übergeben werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Beachten Sie, dass ReadFileFragment-Implementierungen überprüfen müssen, ob sich das angeforderte Schriftartdateifragment innerhalb der Dateigrenzen befindet. Andernfalls sollte ein Fehler von ReadFileFragment zurückgegeben werden.

DirectWrite können IDWriteFontFileStream-Methoden für dasselbe Objekt aus mehreren Threads gleichzeitig aufrufen. Daher müssen ReadFileFragment-Implementierungen , die auf einem internen veränderlichen Zustand basieren, den Zugriff auf diesen Zustand über mehrere Threads serialisieren. Beispielsweise muss eine Implementierung, die separate Such- und Lesevorgänge zum Lesen eines Dateifragments verwendet, den Codeblock, der Seek- und Read-Aufrufe enthält, unter einer Sperre oder einem kritischen Abschnitt platzieren.

Anforderungen

Weitere Informationen

IDWriteFontFileStream