PFNGETINFO-Rückruffunktion (printoem.h)

Artikel
02/07/2025

Die UNIFONTOBJ_GetInfo Rückruffunktion wird vom Unidrv-Treiber bereitgestellt, sodass Rendering-Plug-Ins Schriftart- oder Glypheninformationen abrufen können.

Syntax

PFNGETINFO Pfngetinfo;

BOOL Pfngetinfo(
  _UNIFONTOBJ *unnamedParam1,
  DWORD unnamedParam2,
  PVOID unnamedParam3,
  DWORD unnamedParam4,
  PDWORD unnamedParam5
)
{...}

Parameter

unnamedParam1

Zeiger auf die UNIFONTOBJ Struktur, die von der Funktion empfangen wird, die den Rückruf an UNIFONTOBJ_GetInfo. Vom Anrufer bereitgestellt.

unnamedParam2

Gibt die Größe des Puffers in Bytes an, auf den pData-verweist. Vom Anrufer bereitgestellt.

unnamedParam3

Zeiger auf eine Struktur, wie in der folgenden Tabelle angegeben. Vom Anrufer bereitgestellt.

dwInfoID-Wert	pData--Struktur
UFO_GETINFO_FONTOBJ	GETINFO_FONTOBJ
UFO_GETINFO_GLYPHBITMAP	GETINFO_GLYPHBITMAP
UFO_GETINFO_GLYPHSTRING	GETINFO_GLYPHSTRING
UFO_GETINFO_GLYPHWIDTH	GETINFO_GLYPHWIDTH
UFO_GETINFO_MEMORY	GETINFO_MEMORY
UFO_GETINFO_STDVARIABLE	GETINFO_STDVAR

Weitere Informationen finden Sie in der Tabelle im Abschnitt Hinweise.

unnamedParam4

Gibt den Typ der Struktur an, auf die durch pData-verwiesen wird. Vom Anrufer bereitgestellt. Weitere Informationen finden Sie in der Tabelle im Abschnitt Hinweise.

unnamedParam5

Zeiger auf eine Position, die die minimale Puffergröße in Bytes empfängt, die erforderlich ist, um die struktur zu enthalten, die durch dwInfoIDidentifiziert wird. Vom Anrufer bereitgestellt.

Rückgabewert

Gibt einen BOOL- Wert zurück. Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUEzurück. Andernfalls wird FALSE-zurückgegeben.

Bemerkungen

Mit der UNIFONTOBJ_GetInfo Rückruffunktion kann ein Rendering-Plug-In- wieder in Unidrv aufrufen, um Schriftart- oder Glypheninformationen von GDI abzurufen, die für die Behandlung angepassten Schriftartverwaltung Vorgängen erforderlich sind.

Ein Rendering-Plug-In empfängt die Adresse der UNIFONTOBJ_GetInfo-Funktion in der UNIFONTOBJ- Struktur, die an die Schriftartanpassungsmethoden übergeben wird.

Der Typ der von der Funktion zurückgegebenen Informationen hängt von den Eingabeargumenten ab. Der Aufrufer stellt Werte für dwInfoID, pData-und dwDataSize bereit, um den gewünschten Informationstyp anzugeben. In der folgenden Tabelle sind die Arten der zurückgegebenen Informationen zusammengefasst. Weitere Informationen finden Sie in den Strukturbeschreibungen.

pData--Struktur	Zurückgegebene Informationen
GETINFO_FONTOBJ	Eine FONTOBJ-Struktur, die die aktuelle Schriftart beschreibt.
GETINFO_GLYPHBITMAP	Eine einzelne Glyphenbitmap.
GETINFO_GLYPHSTRING	Ein Array von Glyphenbezeichnern in einem angegebenen Format.
GETINFO_GLYPHWIDTH	Gesamtbreite einer Gruppe von Glyphen.
GETINFO_MEMORY	Die verbleibende Menge des verfügbaren Druckerspeichers.
GETINFO_STDVAR	Der aktuelle Wert für eine oder mehrere der Standardvariablen von Unidrv.

Wenn der durch pData- und dwDataSize- beschriebene Puffer zu klein ist, um die durch dwInfoIDangegebene Struktur zu empfangen, lädt die Funktion die erforderliche Puffergröße an die Position, die von pcbNeededed verweist, und gibt FALSEzurück.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	printoem.h (include Printoem.h)

Freigeben über