IPrintOemUI2::QueryJobAttributes 方法 (prcomoem.h)
方法 IPrintOemUI2::QueryJobAttributes
允许 UI 插件在调用 DrvQueryJobAttributes DDI 后处理核心驱动程序的结果。 插件可以选择覆盖核心驱动程序放置在 lpAttributeInfo 输出缓冲区中的值。
语法
HRESULT QueryJobAttributes(
HANDLE hPrinter,
PDEVMODE pDevmode,
DWORD dwLevel,
LPBYTE lpAttributeInfo
);
参数
hPrinter
指定调用方提供的打印机句柄。
pDevmode
指向调用方提供的 DEVMODEW 结构的指针。
dwLevel
指定调用方提供的值,该值指示 lpAttributeInfo 指向的结构类型,如下表所示。
值 | lpAttributeInfo 指向的结构 |
---|---|
1 | |
2 | |
3 | |
4 |
请注意,如果此方法更改ATTRIBUTE_INFO_N 结构的任何 dwDrvXxx 成员,则后台处理程序假定插件能够支持该成员表示的行为。
lpAttributeInfo
指向内存位置的指针,该位置接收 由 dwLevel 标识的类型结构的地址。
返回值
如果 UI 插件支持此方法,并且该方法成功,则应返回S_OK。 这会导致核心驱动程序为 DrvQueryJobAttributes DDI 返回 TRUE。 如果 UI 插件支持此方法,但该方法失败,则应返回E_FAIL。 这会导致核心驱动程序为 DrvQueryJobAttributes DDI 返回 FALSE 。 如果 UI 插件不支持此方法,则应返回E_NOTIMPL。
注解
当打印机安装了多个 UI 插件时,核心驱动程序会按其安装顺序调用 UI 插件。 支持此方法的最后一个 UI 插件返回的 HRESULT 用于确定核心驱动程序的 DrvQueryJobAttributes DDI 返回值,如上一部分所述。
有关详细信息,请参阅 DrvQueryJobAttributes 。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (包括 Prcomoem.h) |