PFNGETINFO-Rückruffunktion (printoem.h)

Artikel
02/26/2024

Die UNIFONTOBJ_GetInfo Rückruffunktion wird vom Unidrv-Treiber bereitgestellt, damit 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 Aufrufer bereitgestellt.

unnamedParam2

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

unnamedParam3

Zeiger auf eine Struktur, wie in der folgenden Tabelle angegeben. Vom Aufrufer 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 pData verweist. Vom Aufrufer bereitgestellt. Weitere Informationen finden Sie in der Tabelle im Abschnitt Hinweise .

unnamedParam5

Zeiger auf einen Speicherort, der die minimale Puffergröße in Bytes empfängt, die erforderlich ist, um die durch dwInfoID identifizierte Struktur zu enthalten. Vom Aufrufer bereitgestellt.

Rückgabewert

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

Hinweise

Die UNIFONTOBJ_GetInfo-Rückruffunktion ermöglicht es einem Rendering-Plug-In , unidrv zurückzurufen, um Schriftart- oder Glypheninformationen von GDI abzurufen, die für die Verarbeitung von benutzerdefinierten Schriftverwaltungsvorgängen erforderlich sind.

Ein Rendering-Plug-In empfängt die Adresse der UNIFONTOBJ_GetInfo Funktion in der UNIFONTOBJ-Struktur , die an die Schriftartenanpassungsmethoden ü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 Typ der gewünschten Informationen anzugeben. In der folgenden Tabelle sind die zurückgegebenen Informationstypen 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 Glyphenbitbit.
GETINFO_GLYPHSTRING	Ein Array von Glyphenspezifizierern in einem angegebenen Format.
GETINFO_GLYPHWIDTH	Gesamtbreite einer Gruppe von Glyphen.
GETINFO_MEMORY	Menge des verfügbaren Druckerspeichers.
GETINFO_STDVAR	Der aktuelle Wert für eine oder mehrere Standardvariablen von Unidrv.

Wenn der durch pData und dwDataSize beschriebene Puffer zu klein ist, um die durch dwInfoID angegebene Struktur zu empfangen, lädt die Funktion die erforderliche Puffergröße in die Position, die von pcbNeeded verweist, und gibt FALSE zurück.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	printoem.h (include Printoem.h)

Freigeben über