IPrintOemPS::P ublishDriverInterface-Methode (prcomoem.h)

  • Artikel

Die IPrintOemPS::PublishDriverInterface -Methode ermöglicht es einem Rendering-Plug-In für Pscript5, die IPrintCorePS2-, IPrintOemDriverPS- oder IPrintCoreHelperPS-Schnittstelle des Pscript5-Treibers abzurufen.

Syntax

HRESULT PublishDriverInterface(
  IUnknown *pIUnknown
);

Parameter

pIUnknown

Vom Aufrufer bereitgestellter Zeiger auf die IUnknown-Schnittstelle der IPrintCorePS2 COM-Schnittstelle des Treibers, der IPrintOemDriverPS COM-Schnittstelle oder der IPrintCoreHelperPS-Schnittstelle.

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

Hinweise

Der Pscript5-Treiber unterstützt die Schnittstellen IPrintCorePS2, IPrintOemDriverPS und IPrintCoreHelperPS . Ein Rendering-Plug-In für Pscript5 muss die IPrintOemPS::PublishDriverInterface -Methode implementieren. Die -Methode sollte Informationen zu den unterstützten Pscript5-Schnittstellen wie folgt zurückgeben:

  1. Der Pscript5-Treiber ruft zuerst die IPrintOemPS::PublishDriverInterface -Methode auf, wobei der pIUnknown-Zeiger auf die IUnknown-Schnittstelle der IUnknown-instance festgelegt ist. Wenn das Rendering-Plug-In die IPrintCorePS2-Schnittstelle verwenden kann, muss die Methode S_OK zurückgeben. Andernfalls sollte das Plug-In E_FAIL zurückgeben.
  2. Wenn das Plug-In E_FAIL zurückgegeben hat, ruft der Pscript5-Treiber die IPrintOemPS::PublishDriverInterface -Methode erneut auf, wobei der pIUnknown-Zeiger jedoch auf die IUnknown-Schnittstelle von IPrintOemDriverPS instance festgelegt ist. Wenn das Plug-In die IPrintOemDriverPS-Schnittstelle verwenden kann, muss die Methode S_OK zurückgeben. Andernfalls sollte das Plug-In E_FAIL zurückgeben.
  3. Wenn die IPrintOemPS::GetInfo-Methode des Plug-Ins als Reaktion auf einen Aufruf mit dwMode auf OEMGI_GETREQUESTEDHELPERINTERFACES in pBuffer den Wert OEMPUBLISH_IPRINTCOREHELPER in pBuffer zurückgegeben hat, ruft der Pscript5-Treiber die IPrintOemPS::PublishDriverInterface -Methode erneut auf, wobei der pIUnknown-Zeiger jedoch auf ein Objekt festgelegt ist, das die Schnittstellen IPrintCoreHelperPS und IPrintCoreHelper implementiert. Wenn das Plug-In einen Zeiger auf die Objektschnittstelle beibehält, sollte die Methode S_OK zurückgeben. Andernfalls sollte die -Methode E_FAIL zurückgeben.
Wenn das Plug-In alle Aufrufe von IPrintOemPS::PublishDriverInterfacefehlschlägt, empfängt das Plug-In keine weiteren Aufrufe. Wenn das Plug-In IPrintCorePS2-, IPrintOemDriverPS- oder IPrintCoreHelperPS-Schnittstellenmethoden aufruft, muss es den empfangenen IUnknown-Schnittstellenzeiger verwenden, um IUnknown::QueryInterface aufzurufen (in der Microsoft Windows SDK-Dokumentation beschrieben), um einen Zeiger auf die vom Treiber unterstützte Version von IPrintCorePS2, IPrintOemDriverPS oder zu erhalten.IPrintCoreHelperPS-Schnittstelle. Weitere Informationen finden Sie unter Zugreifen auf Druckertreiberschnittstellen über Plug-Ins.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile prcomoem.h (include Prcomoem.h)

Weitere Informationen

IPrintOemPS

IPrintOemPS::GetInfo