DrvQueryFont-Funktion (winddi.h)

Die DrvQueryFont-Funktion wird von GDI verwendet, um die IFIMETRICS-Struktur für eine bestimmte Schriftart abzurufen.

Syntax

PIFIMETRICS DrvQueryFont(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG_PTR *pid
);

Parameter

dhpdev

Handle für die PDEV des physischen Geräts, die ein physisches Gerät identifiziert. Der PDEV wurde von einem vorherigen Aufruf von DrvEnablePDEV zurückgegeben.

iFile

Zeiger auf einen vom Treiber definierten Wert, der eine Treiberschriftartdatei identifiziert. Dieser Zeiger wird von DrvLoadFontFile zurückgegeben. Dieser Parameter ist 0 (null) für geräteresidente Schriftarten.

iFace

Gibt den 1-basierten Index der Treiberschriftart an. GDI kann die Anzahl der Schriftarten aus der DEVINFO-Struktur abfragen.

pid

Zeiger auf einen Speicherort mit der Adresse eines treiberdefinierten Werts, den GDI an DrvFree übergibt, wenn die IFIMETRICS-Struktur nicht mehr benötigt wird. Abhängig davon, wie der Treiber den Arbeitsspeicher verwaltet, kann dieser 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 IFIMETRICS-Struktur , die die angegebene Schriftart beschreibt, wenn die Funktion erfolgreich ist. Andernfalls ist er NULL, und ein Fehlercode wird protokolliert.

Hinweise

Der Treiber füllt die IFIMETRICS-Struktur aus.

Die IFIMETRICS-Struktur muss während des Bereichs der zugeordneten PDEV unverändert bleiben.

Wenn die Anzahl der Schriftarten in DEVINFO -1 und iFace null ist, sollte der Treiber die Anzahl der unterstützten Schriftarten zurückgeben.

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

Anforderungen

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

Weitere Informationen

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

IFIMETRICS