IPrintOemPS::GetInfo-Methode (prcomoem.h)
Die IPrintOemPS::GetInfo Methode eines Rendering-Plug-Ins gibt Identifikationsinformationen 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 Bitkennzeichnungswert von OEMPUBLISH_IPRINTCOREHELPER in den Puffer schreiben, pBuffer, wenn die IPrintOemPS::P ublishDriverInterface-Methode mit Parameter pIUnknown aufgerufen werden auf ein Objekt zeigt, das die IPrintCoreHelperPS Interfaceimplementiert.
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 der OEMCUIPPARAMbeschrieben. die pOEMOptItems Member der Struktur.
OEMGI_GETVERSION
Die Methode muss die Versionsnummer des Plug-Ins der Benutzeroberfläche als DWORD zurückgeben. Das Versionsformat ist vom Entwickler definiert.
pBuffer
Vom Aufrufer bereitgestellter Zeiger auf den Speicher, der für den Empfang der durch dwModeangegebenen Informationen zugewiesen ist.
cbSize
Vom Aufrufer bereitgestellte Größe des Puffers, auf den pBuffer-verweist.
pcbNeeded
Vom Aufrufer bereitgestellter Zeiger auf eine Position, um die Anzahl der in den Puffer geschriebenen Bytes zu empfangen, auf die durch pBuffer-verwiesen wird.
Rückgabewert
Die Methode muss einen der folgenden Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Vorgang war erfolgreich. |
|
Fehler beim Vorgang. |
|
Die Methode ist nicht implementiert. |
Bemerkungen
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 in die durch pBuffer angegebene Adresse geschrieben und die Größe der zurückgegebenen Informationen in Byte in die durch pcbNeedededangegebene Position geschrieben.
Wenn pBuffer-NULL-ist, sollte die Methode nur pcbNeed verwenden, um die Anzahl der Bytes zurückzugeben, die zum Speichern der angegebenen Informationen erforderlich sind.
Im "Veröffentlichungsmodus" werden alle schriftarteninformationen, die heruntergeladen werden sollen, in der Auftragskopfzeile platziert. Jede Schriftart wird nur einmal heruntergeladen und kann für jede Seite verwendet werden, sodass der Auftrag unabhängig von der Seitenreihenfolge sein kann. Wenn dwMode- OEMGI_GETPUBLISHERINFO ist, aber das Plug-In den Veröffentlichungsmodus nicht unterstützt, sollte IPrintOemPS::GetInfo 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 |
| Header- | prcomoem.h (einschließlich Prcomoem.h) |