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) |