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