IPrintOemUni::P ublishDriverInterface 方法 (prcomoem.h)
方法 IPrintOemUni::PublishDriverInterface
允许 Unidrv 的呈现插件获取 Unidrv 驱动程序的 IPrintOemDriverUni 或 IPrintCoreHelperUni 接口。
语法
HRESULT PublishDriverInterface(
IUnknown *pIUnknown
);
参数
pIUnknown
调用方提供的指向驱动程序的 IPrintOemDriverUni COM 接口或 IPrintCoreHelperUni 接口的 IUnknown 接口的指针。
返回值
方法必须返回以下值之一。
返回代码 | 说明 |
---|---|
|
操作成功。 |
|
此操作失败。 |
注解
Unidrv 的呈现插件必须实现 IPrintOemUni::PublishDriverInterface
方法,并且该方法必须返回S_OK以响应至少一次调用。 否则,驱动程序不会调用插件的其他 IPrintOemUni 接口方法。
方法应返回有关其支持的 Unidrv 接口的信息,如下所示:
-
Unidrv 驱动程序首先调用 方法,
IPrintOemUI::PublishDriverInterface
并将 pIUnknown 指针设置为 IPrintOemDriverUni 实例的 IUnknown 接口。 如果呈现插件将调用 IPrintOemDriverUni 接口方法,则必须使用接收的 IUnknown 接口指针调用 Microsoft Windows SDK 文档) 中所述的 IUnknown::QueryInterface (,以获取指向驱动程序支持的 IPrintOemDriverUni 接口版本的指针。 有关详细信息,请参阅 打印机驱动程序的接口标识符。 -
如果插件的 IPrintOemUni::GetInfo 方法在 pBuffer 中返回值 OEMPUBLISH_IPRINTCOREHELPER,以响应 dwMode 设置为 OEMGI_GETREQUESTEDHELPERINTERFACES 的调用,则 Unidrv 驱动程序会再次调用
IPrintOemUni::PublishDriverInterface
该方法,但 pIUnknown 指针设置为实现 IPrintCoreHelperUni 和 IPrintCoreHelper 接口的对象。 如果插件保留指向 对象的指针,则 该方法应返回S_OK。 否则,方法应返回E_FAIL。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (包括 Prcomoem.h) |