IPrintOemDriverUni::DrvGetDriverSetting 方法由 Unidrv 驱动程序提供,以便呈现插件可以获取打印机功能的当前状态和其他内部信息。
语法
HRESULT DrvGetDriverSetting(
PVOID pdriverobj,
PCSTR Feature,
PVOID pOutput,
DWORD cbSize,
PDWORD pcbNeeded,
PDWORD pdwOptionsReturned
);
参数
pdriverobj
调用方提供的指向 DEVOBJ 结构的指针。
Feature
调用方提供的值,用于标识将为其返回选项设置的打印机功能。 这可以是字符串指针或常量,如以下“备注”部分所述。
pOutput
调用方提供的指向缓冲区的指针,用于接收指定的信息。
cbSize
pOutput指向的缓冲区的调用方提供的大小(以字节为单位)。
pcbNeeded
调用方提供的指针指向接收包含所请求信息所需的最小缓冲区大小的位置。
pdwOptionsReturned
调用方提供的指针指向接收放置在 pOutput 中的选项字符串数的位置。
返回值
该方法必须返回以下值之一。
| 返回代码 | 描述 |
|---|---|
|
作成功。 |
|
作失败。 |
|
未实现该方法。 |
言论
调用 IPrintOemDriverUni::DrvGetDriverSetting 方法时,可以为 pFeatureKeyword指定字符串指针或常量值。
-
如果 pFeatureKeyword 为字符串,则它必须表示在 Unidrv 微型驱动程序 GPD 文件中指定的功能名称
该方法应在 pOutput指向的缓冲区中返回一个或多个以 NULL 结尾的字符串。 每个字符串应表示当前所选选项的名称。 应在 pdwOptionsReturned中返回字符串数。
- 如果 pFeatureKeyword 为常量,则它必须是 printoem.h 中定义的 OEMGDS_前缀常量之一。 该方法应返回指定常量指示的值,方法是将其放置在由 pOutput指向的缓冲区中。 pdwOptionsReturned 中返回的值必须为 1。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | prcomoem.h (include Prcomoem.h) |