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 指向的缓冲区的字节数。
返回值
方法必须返回以下值之一。
返回代码 | 说明 |
---|---|
|
操作成功。 |
|
操作失败 |
|
该方法未实现。 |
注解
Pscript5 的呈现插件需要实现 IPrintOemPS::GetInfo
方法,该方法在加载插件后立即调用。 方法应通过将指定信息写入 pBuffer 指定的地址,并将返回的信息的大小(以字节为单位)写入 到由德美德Needed 指定的位置来返回。
如果 pBuffer 为 NULL,则该方法应 仅使用标 返回存储指定信息所需的字节数。
在“发布模式”中,要下载的所有字体信息都放置在作业标头中。 每个字体仅下载一次,并且可用于任何页面,从而允许作业独立于页面顺序。 如果 dwMode OEMGI_GETPUBLISHERINFO但插件不支持发布模式, IPrintOemPS::GetInfo
应返回 E_NOTIMPL。
有关创建和安装呈现插件的详细信息,请参阅 自定义 Microsoft 的打印机驱动程序。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (包括 Prcomoem.h) |