Freigeben über


DrvQueryFontTree-Funktion (winddi.h)

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.

Hinweise

Die zurückgegebene Struktur muss unverändert bleiben, bis GDI DrvFree mit der Adresse der -Struktur aufruft.

DrvQueryFontTree ist für Schriftarttreiber und Treiber erforderlich, die gerätespezifische Schriftarten verwenden.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)

Weitere Informationen

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

DrvQueryFontData

DrvQueryFontTree

FD_GLYPHSET

FD_KERNINGPAIR

IFIMETRICS