IPrintOemPS::GetInfo-Methode (prcomoem.h)

  • Artikel

Die Methode eines Rendering-Plug-Ins gibt Identifikationsinformationen IPrintOemPS::GetInfo zurück.

Syntax

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

Parameter

dwMode

Enthält eine der folgenden vom Aufrufer bereitgestellten ganzzahligen Konstanten.

OEMGI_GETPUBLISHERINFO

Die -Methode muss angeben, ob das Rendering-Plug-In den "Veröffentlichungsmodus" verwendet. Der pBuffer-Parameter verweist auf eine PUBLISHERINFO-Struktur , die von der -Methode ausgefüllt werden soll. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

OEMGI_GETREQUESTEDHELPERINTERFACES

Die Methode muss den Bitflagwert von OEMPUBLISH_IPRINTCOREHELPER in den Puffer pBuffer schreiben, wenn die IPrintOemPS::P ublishDriverInterface-Methode mit dem Parameter pIUnknown aufgerufen werden soll, der auf ein Objekt verweist, das die IPrintCoreHelperPS-Schnittstelle implementiert.

OEMGI_GETSIGNATURE

Die Methode muss eine eindeutige Vier-Byte-Identifikationssignatur zurückgeben. Das Plug-In muss diese Signatur auch in OPTITEM-Strukturen platzieren, wie in der Beschreibung des OEMCUIPPARAM beschrieben. pOEMOptItems-Member der -Struktur.

OEMGI_GETVERSION

Die Methode muss die Versionsnummer des Benutzeroberflächen-Plug-Ins als DWORD zurückgeben. Das Versionsformat ist vom Entwickler definiert.

pBuffer

Vom Aufrufer bereitgestellter Zeiger auf den Speicher, der für den Empfang der von dwMode angegebenen Informationen zugewiesen ist.

cbSize

Vom Aufrufer bereitgestellte Größe des Puffers, auf den pBuffer verweist.

pcbNeeded

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, an dem die Anzahl von Bytes empfangen werden soll, die in den Puffer geschrieben wurden, auf den pBuffer verweist.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL
 Fehler beim Vorgang
E_NOTIMPL
 Die Methode ist nicht implementiert.

Hinweise

Rendering-Plug-Ins für Pscript5 sind erforderlich, um die IPrintOemPS::GetInfo Methode zu implementieren, die unmittelbar nach dem Laden des Plug-Ins aufgerufen wird. Die Methode sollte die angegebenen Informationen zurückgeben, indem sie sie an die von pBuffer angegebene Adresse schreibt und die Größe der zurückgegebenen Informationen in Bytes an den von pcbNeeded angegebenen Speicherort schreibt.

Wenn pBufferNULL ist, sollte die Methode einfach pcbNeeded verwenden, um die Anzahl von Bytes zurückzugeben, die zum Speichern der angegebenen Informationen erforderlich sind.

Im "Veröffentlichungsmodus" werden alle zu herunterladenden Schriftartinformationen im Auftragsheader platziert. Jede Schriftart wird nur einmal heruntergeladen und kann für jede Seite verwendet werden, sodass der Auftrag unabhängig von der Seitenreihenfolge ist. Wenn dwMode OEMGI_GETPUBLISHERINFO, aber das Plug-In den Veröffentlichungsmodus nicht unterstützt, IPrintOemPS::GetInfo sollte E_NOTIMPL zurückgeben.

Weitere Informationen zum Erstellen und Installieren von Rendering-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile prcomoem.h (einschließlich Prcomoem.h)

Weitere Informationen

IPrintOemPS

IPrintOemUI::GetInfo

IPrintOemUni::GetInfo