DrvQueryAdvanceWidths-Funktion (winddi.h)

Die DrvQueryAdvanceWidths-Funktion gibt zeichenweitere Breiten für einen angegebenen Satz von Glyphen zurück.

Syntax

BOOL DrvQueryAdvanceWidths(
        DHPDEV  dhpdev,
        FONTOBJ *pfo,
        ULONG   iMode,
  [in]  HGLYPH  *phg,
  [out] PVOID   pvWidths,
        ULONG   cGlyphs
);

Parameter

dhpdev

Handle für die PDEV des physischen Geräts, die zuvor von DrvEnablePDEV zurückgegeben wurde.

pfo

Zeiger auf eine FONTOBJ-Struktur, die die Schriftart instance identifiziert.

iMode

Gibt den Typ der bereitgestellten Informationen an. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
QAW_GETEASYWIDTHS	Die Zeichenvorrückbreiten werden als Array von 12,4 Festkommazahlen zurückgegeben. Dieser Modus wird nicht verwendet, wenn die Breite den Bereich der 12,4-Darstellung überschreitet. Diese Routine sollte die Breite so schnell wie möglich berechnen. Wenn die Berechnung der Zeichenvorlaufbreite einer Glyphe nicht effizient erreicht werden kann, sollte der Treiber 0xFFFF in den Puffer für diese Glyphe schreiben. Die Funktion gibt DDI_ERROR zurück, wenn ein Fehler auftritt, FALSE , wenn nicht alle Breiten für diesen Modus effizient berechnet werden können, oder TRUE in allen anderen Fällen.
QAW_GETWIDTHS	Die Zeichenvorschreibbreiten werden als Array von 12,4 Festkommazahlen aufgezeichnet. Dieser Modus wird nicht verwendet, wenn die Breite den Bereich der 12,4-Darstellung überschreitet. Die Funktion gibt TRUE zurück, wenn dies erfolgreich ist.

[in] phg

Zeiger auf ein Array von Glyphenhandles, die die Glyphen angeben, für die der Treiber Zeichenvorschubbreiten zurückgibt.

[out] pvWidths

Zeiger auf einen Puffer, in dem der Treiber Daten erfasst.

cGlyphs

Gibt die Anzahl der Glyphen im Eingabepuffer an, auf die von phg verwiesen wird.

Rückgabewert

Der Rückgabewert ist vom Wert des iMode-Parameters abhängig.

Anforderungen

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

Weitere Informationen

DrvEnablePDEV

FONTOBJ