PFNGETINFO-Rückruffunktion (printoem.h)

  • Artikel

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)