DrvQueryFontCaps-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvQueryFontCaps-Funktion definiert die Funktionen des Schriftarttreibers.

Syntax

LONG DrvQueryFontCaps(
  ULONG culCaps,
  ULONG *pulCaps
);

Parameter

culCaps

Gibt die Anzahl der ULONG-Werte in dem Array an, auf das der pulCaps-Parameter verweist, der vom Schriftarttreiber geschrieben werden kann.

pulCaps

Zeiger auf ein Array, das die Im ersten Parameter angegebene Anzahl von Werten empfängt. Die Elemente des Arrays haben die folgende Bedeutung:

Element	Bedeutung
pulCaps[0]	Eine Anzahl der ULONG-Werte im vollständigen Array. Wenn culCaps kleiner als dieser Wert ist, erhält der Aufrufer ein unvollständiges Array.
pulCaps[1]	Eine Gruppe von Flags, die mindestens einen der folgenden Werte sein können: QC_OUTLINES Wenn dieses Flag festgelegt ist, kann der Schriftarttreiber eine Gliederungsbeschreibung der Glyphen zurückgeben. Darüber hinaus wird davon ausgegangen, dass die Schriftarten skalierbar sind. Bitmapschriftarten verfügen nicht über dieses Flag. QC_1BIT Gibt an, dass der Schriftarttreiber monochrome Bitmaps jeder Glyphe zurückgeben kann. QC_4BIT Gibt an, dass der Schriftarttreiber antialiasierte 4-Bits-pro-Pixel-Bitmaps zurückgeben kann. Jedes Pixel in der Bitmap wird durch einen unsignierten 4-Bit-Wert im Bereich von 0 bis 15 dargestellt, der 16 Graustufen ergibt.

Element

Bedeutung

pulCaps[0]

Eine Anzahl der ULONG-Werte im vollständigen Array. Wenn culCaps kleiner als dieser Wert ist, erhält der Aufrufer ein unvollständiges Array.

pulCaps[1]

Eine Gruppe von Flags, die mindestens einen der folgenden Werte sein können:

QC_OUTLINES
Wenn dieses Flag festgelegt ist, kann der Schriftarttreiber eine Gliederungsbeschreibung der Glyphen zurückgeben. Darüber hinaus wird davon ausgegangen, dass die Schriftarten skalierbar sind. Bitmapschriftarten verfügen nicht über dieses Flag.

QC_1BIT
Gibt an, dass der Schriftarttreiber monochrome Bitmaps jeder Glyphe zurückgeben kann.

QC_4BIT
Gibt an, dass der Schriftarttreiber antialiasierte 4-Bits-pro-Pixel-Bitmaps zurückgeben kann. Jedes Pixel in der Bitmap wird durch einen unsignierten 4-Bit-Wert im Bereich von 0 bis 15 dargestellt, der 16 Graustufen ergibt.

Rückgabewert

Der Rückgabewert ist die Anzahl der ULONG-Werte, die in den Zielpuffer geschrieben werden, wenn die Funktion erfolgreich ist. Andernfalls wird sie FD_ERROR.

Hinweise

Ein Treiber meldet möglicherweise, dass er mehrere Formate für eine Schriftart unterstützt. Beispielsweise könnte ein Treiber im Prinzip sowohl mit QC_1BIT als auch mit QC_4BIT festgelegt zurückgeben, was angibt, dass er sowohl monochrome als auch antialiasierte Versionen der Schriftart zurückgeben kann. Alle bitmaps, die von einem Schriftarttreiber generiert werden, müssen auf 32-Bit-Grenzen beginnen und enden. Bei Bedarf sollte das Ende einer Bitmap "gepolstert" sein, um diese Anforderung zu erfüllen.

Anforderungen

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

Weitere Informationen

DrvQueryFont

DrvQueryFontTree

Share via