DrvQueryFontTree-Funktion (winddi.h)

Artikel
03/04/2024

Die DrvQueryFontTree-Funktion stellt GDI einen Zeiger auf eine Struktur bereit, die eine der folgenden Definiert:

Eine Zuordnung von Unicode- zu Glyphenhandles, einschließlich Glyphenvarianten
Eine Zuordnung von Kerningpaaren zu Kerning-Handles

Syntax

PVOID DrvQueryFontTree(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG     iMode,
  ULONG_PTR *pid
);

Parameter

dhpdev

Identifiziert ein Gerät durch ein Handle für seine PDEV, das von einem vorherigen Aufruf von DrvEnablePDEV zurückgegeben wurde.

iFile

Identifiziert die Schriftartdatei des Treibers. Dieser Wert wird von DrvLoadFontFile zurückgegeben.

iFace

Gibt den 1-basierten Index der Treiberschriftart an.

iMode

Gibt den Typ der bereitgestellten Informationen an. Mögliche Werte:

Wert	Bedeutung
QFT_GLYPHSET	GDI fordert einen Zeiger auf eine FD_GLYPHSET-Struktur an, die die Zuordnungen von einzelnen Unicode-Zeichen zu Glyphenhandles definiert.
QFT_KERNPAIRS	GDI fordert einen Zeiger auf ein sortiertes Array mit NULL-Endung von FD_KERNINGPAIR-Strukturen an. Die Kerningpaare sollten in zunehmender Reihenfolge gespeichert werden. Der Primärschlüssel ist das zweite Unicode-Zeichen. Der sekundäre Schlüssel ist das erste Unicode-Zeichen im Kerningpaar.

pid

Zeiger auf einen Speicherort, an dem die Adresse eines vom Treiber definierten Werts enthalten ist. GDI übergibt den Inhalt von *pid zusammen mit dem zurückgegebenen Zeiger an DrvFree, wenn die FD_GLYPHSET Struktur oder das Array von FD_KERNINGPAIR Strukturen nicht mehr benötigt wird. Je nachdem, wie der Arbeitsspeicher im Treiber verwaltet wird, kann der vom Treiber definierte Wert die Struktur identifizieren, die Art und Weise identifizieren, wie sie zugeordnet wurde, oder überhaupt nichts tun.

Rückgabewert

Der Rückgabewert ist ein Zeiger auf die angeforderte Struktur, wenn die Funktion erfolgreich ist. Andernfalls ist er NULL, und ein Fehlercode wird protokolliert.