iPrintOemPS::GetInfo 方法 (prcomoem.h)

呈现插件的 IPrintOemPS::GetInfo 方法返回标识信息。

语法

HRESULT GetInfo(
  DWORD  dwMode,
  PVOID  pBuffer,
  DWORD  cbSize,
  PDWORD pcbNeeded
);

参数

dwMode

包含以下调用方提供的整数常量之一。

OEMGI_GETPUBLISHERINFO

方法必须指示呈现插件是否将使用“发布模式”。 pBuffer 参数指向要由 方法填充的 PUBLISHERINFO 结构。 有关更多信息,请参见下面的“备注”部分。

OEMGI_GETREQUESTEDHELPERINTERFACES

如果应使用指向实现 IPrintCoreHelperPS 接口的对象的参数 pIUnknown 调用 IPrintOemPS::P ublishDriverInterface 方法,则方法必须将 OEMPUBLISH_IPRINTCOREHELPER 的位标志值写入缓冲区 pBuffer

OEMGI_GETSIGNATURE

方法必须返回唯一的四字节标识签名。 插件还必须将此签名放置在 OPTITEM 结构中,如 OEMCUIPPARAM 的说明中所述。 结构的 pOEMOptItems 成员。

OEMGI_GETVERSION

方法必须以 DWORD 的形式返回用户界面插件的版本号。 版本格式由开发人员定义。

pBuffer

调用方提供的指针,指向分配用于接收 dwMode 指定信息的内存。

cbSize

pBuffer 指向的缓冲区的调用方提供的大小。

pcbNeeded

调用方提供的指向位置的指针,用于接收写入 pBuffer 指向的缓冲区的字节数。

返回值

方法必须返回以下值之一。

返回代码 说明
S_OK
操作成功。
E_FAIL
操作失败
E_NOTIMPL
该方法未实现。

注解

Pscript5 的呈现插件需要实现 IPrintOemPS::GetInfo 方法,该方法在加载插件后立即调用。 方法应通过将指定信息写入 pBuffer 指定的地址,并将返回的信息的大小(以字节为单位)写入 到由德美德Needed 指定的位置来返回。

如果 pBufferNULL,则该方法应 仅使用标 返回存储指定信息所需的字节数。

在“发布模式”中,要下载的所有字体信息都放置在作业标头中。 每个字体仅下载一次,并且可用于任何页面,从而允许作业独立于页面顺序。 如果 dwMode OEMGI_GETPUBLISHERINFO但插件不支持发布模式, IPrintOemPS::GetInfo 应返回 E_NOTIMPL。

有关创建和安装呈现插件的详细信息,请参阅 自定义 Microsoft 的打印机驱动程序

要求

要求
目标平台 桌面
标头 prcomoem.h (包括 Prcomoem.h)

另请参阅

IPrintOemPS

IPrintOemUI::GetInfo

IPrintOemUni::GetInfo