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
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |