Schnittstellenbezeichner für Druckertreiber

Wichtig

Es wird empfohlen, den IPP-Posteingangsklassentreiber von Microsoft zusammen mit Druckunterstützungs-Apps (PSA) zu verwenden, um die Druckoberfläche in Windows 10 und 11 für die Druckergeräteentwicklung anzupassen.

Weitere Informationen finden Sie im Designhandbuch für Druckunterstützungs-Apps.

Eine Gruppe von GUIDs ist in prcomoem.h definiert. Jede dieser GUIDs ist ein Schnittstellenbezeichner für eine der COM-Schnittstellen, die für die Kommunikation zwischen den Druckertreibern (Unidrv und Pscript5) und Plug-Ins verwendet werden.

Für Windows 2000 und Windows XP werden die folgenden GUIDs definiert:

IID_IPrintOemUIIID_IPrintOemUI2 (Pscript5 UI-Plug-Ins unter Windows XP und höheren Versionen des Windows-Betriebssystems) IID_IPrintOemDriverUIIID_IPrintCoreUI2 (Pscript5 UI-Plug-Ins unter Windows XP und höheren Versionen des Windows-Betriebssystems) IID_IPrintOemUniIID_IPrintOemUni2 (Unidrv-Render-Plug-Ins unter Windows XP und höheren Versionen des Windows-Betriebssystems) IID_IPrintOemUni3 (Unidrv-Render-Plug-Ins unter Windows Vista und höheren Versionen des Windows-Betriebssystems) IID_IPrintOemDriverUniIID_IPrintOemPSIID_IPrintOemPS2 (Pscript5-Render-Plug-Ins unter Windows XP und höheren Versionen des Windows-Betriebssystems) IID_IPrintOemDriverPSIID_IPrintCorePS2 (Pscript5-Render-Plug-Ins unter Windows XP und höheren Versionen des Windows-Betriebssystems) Jede GUID identifiziert eine Version einer Schnittstelle. Wenn eine neue Version einer Schnittstelle definiert ist, wird der Liste eine neue GUID hinzugefügt.

Benutzeroberflächen-Plug-Ins und Rendering-Plug-Ins müssen die von ihnen unterstützten Schnittstellenversionen identifizieren. Der Druckertreiber (Unidrv oder Pscript5) ruft die IUnknown::QueryInterface-Methode eines Plug-Ins auf (in der Windows SDK-Dokumentation beschrieben) und gibt einen Schnittstellenbezeichner als Eingabe an. Wenn das Plug-In die angegebene Version unterstützt, muss die Methode einen Zeiger auf die Schnittstelle sowie einen Rückgabestatus von S_OK zurückgeben. Andernfalls muss E_NOINTERFACE zurückgegeben werden. Der Treiber beginnt mit dem Schnittstellenbezeichner für die neueste Version und ruft Weiterhin QueryInterface mit früheren Versionsbezeichnern auf, bis die Methode S_OK zurückgibt oder der Treiber die Liste der Versionsbezeichner erschöpft.

Ebenso stellen Unidrv und Pscript5 IUnknown::QueryInterface-Methoden für die COM-Schnittstellen IPrintOemDriverUI, IPrintCoreUI2, IPrintOemDriverUni, IPrintOemDriverPS oder IPrintCorePS2 bereit. Plug-Ins sollten die QueryInterface-Methode der entsprechenden Schnittstelle aufrufen, um die unterstützte Schnittstellenversion des Treibers zu ermitteln und einen Schnittstellenzeiger zu erhalten.