Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The IPrintOemPS::PublishDriverInterface method allows a rendering plug-in for Pscript5 to obtain the Pscript5 driver's IPrintCorePS2, IPrintOemDriverPS, or IPrintCoreHelperPS interface.
Syntax
HRESULT PublishDriverInterface(
IUnknown *pIUnknown
);
Parameters
pIUnknown
Caller-supplied pointer to the IUnknown interface of the driver's IPrintCorePS2 COM Interface, IPrintOemDriverPS COM Interface, or IPrintCoreHelperPS Interface.
Return value
The method must return one of the following values.
| Return code | Description |
|---|---|
|
The operation succeeded. |
|
The operation failed |
Remarks
The Pscript5 driver supports the IPrintCorePS2, IPrintOemDriverPS, and IPrintCoreHelperPS interfaces. A rendering plug-in for Pscript5 must implement the IPrintOemPS::PublishDriverInterface method. The method should return information on its supported Pscript5 interfaces as follows:
-
The Pscript5 driver first calls the
IPrintOemPS::PublishDriverInterfacemethod with the pIUnknown pointer set to the IPrintCorePS2 instance's IUnknown interface. If the rendering plug-in is able to use the IPrintCorePS2 interface, the method must return S_OK. Otherwise, the plug-in should return E_FAIL. -
If the plug-in has returned E_FAIL, the Pscript5 driver calls the
IPrintOemPS::PublishDriverInterfacemethod again, but with the pIUnknown pointer set to the IPrintOemDriverPS instance's IUnknown interface. If the plug-in is able to use the IPrintOemDriverPS interface, the method must return S_OK. Otherwise, the plug-in should return E_FAIL. -
If the plug-in's IPrintOemPS::GetInfo method has returned a value of OEMPUBLISH_IPRINTCOREHELPER in pBuffer in response to a call with dwMode set to OEMGI_GETREQUESTEDHELPERINTERFACES in pBuffer, the Pscript5 driver calls the
IPrintOemPS::PublishDriverInterfacemethod again, but with the pIUnknown pointer set to an object that implements the IPrintCoreHelperPS and IPrintCoreHelper interfaces. If the plug-in retains a pointer to the object interface, the method should return S_OK. Otherwise, the method should return E_FAIL.
IPrintOemPS::PublishDriverInterface, the plug-in will not receive further calls. If the plug-in will be calling IPrintCorePS2, IPrintOemDriverPS, or IPrintCoreHelperPS interface methods, it must use the received IUnknown interface pointer to call IUnknown::QueryInterface (described in the Microsoft Windows SDK documentation) in order to obtain a pointer to the driver's supported version of the IPrintCorePS2, IPrintOemDriverPS, or IPrintCoreHelperPS interface. For more information, see Accessing Printer Driver Interfaces from Plug-Ins.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | prcomoem.h (include Prcomoem.h) |