IPrintOemPS::GetInfo-Methode (prcomoem.h)
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 |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Fehler beim Vorgang |
|
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) |