IPrintCorePS2::GetOptionAttribute 方法 (prcomoem.h)

方法 IPrintCorePS2::GetOptionAttribute 检索选项属性列表或特定选项属性的值。

语法

HRESULT GetOptionAttribute(
  [in]  PDEVOBJ pdevobj,
  [in]  DWORD   dwFlags,
  [in]  PCSTR   pszFeatureKeyword,
  [in]  PCSTR   pszOptionKeyword,
  [in]  PCSTR   pszAttribute,
  [out] PDWORD  pdwDataType,
  [out] PBYTE   pbData,
  [in]  DWORD   cbSize,
  [out] PDWORD  pcbNeeded
);

参数

[in] pdevobj

指向 DEVOBJ 结构的指针。

[in] dwFlags

为保留,并且必须设置为零。

[in] pszFeatureKeyword

指向调用方提供的缓冲区的指针,该缓冲区包含 ASCII 字符串,指定要查询的单个功能关键字 (keyword) 。

[in] pszOptionKeyword

指向调用方提供的缓冲区的指针,该缓冲区包含 ASCII 字符串,该字符串指定要查询的单个选项关键字 (keyword) 。 此值可以从之前调用 IPrintCorePS2::EnumOptions 获取。

[in] pszAttribute

指向调用方提供的缓冲区的指针,该缓冲区包含指定所请求的单个属性的 ASCII 字符串。 如果此参数为 NULL,则调用方请求选项的所有受支持属性名称的列表,而不是为选项指定特定的属性名称。

[out] pdwDataType

指向内存位置的指针,该位置接收指定所请求属性的数据类型的值。 此值是 printoem.h 中定义的 EATTRIBUTE_DATATYPE 枚举的枚举器。

[out] pbData

指向调用方提供的缓冲区的指针,该缓冲区接收请求的数据。 若要仅查询满足请求所需的字节数,请将此参数设置为 NULL

[in] cbSize

指定 pbData 指向的缓冲区的大小(以字节为单位)。

[out] pcbNeeded

指向接收所请求数据的实际大小(以字节为单位)的内存位置的指针。

返回值

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

返回代码 说明
S_OK
方法成功。
E_OUTOFMEMORY
cbSize 中的值小于 (pbData) 指向的缓冲区写入输出缓冲区的字节数。

调用 方法时 ,pbData 设置为 NULL

E_INVALIDARG
方法尝试查询不存在的属性。

无法识别功能关键字 (keyword) 名称或选项关键字 (keyword) 名称。

pdevobj 参数指向无效的驱动程序上下文对象。

E_FAIL
方法失败。

注解

如果调用此方法时,其 pszAttributepbData 参数设置为 NULL,则该方法返回 *印刷板Needed 设置为选项的所有受支持属性名称列表所需的字节数。 如果第二次调用该方法,并且 pszAttribute 设置为 NULL,pbData 指向在上一次调用中 *EATTRIBUTE_DATATYPE Needed 中指定的大小的缓冲区,则该方法返回 *pdwDataType 设置为kADT_ASCII (EATTRIBUTE_DATATYPE枚举类型的枚举器 ) ,pbData 指向选项支持的所有属性名称的 null 分隔列表。 此列表以两个空字符结尾。

若要减少对每个数据访问进行两次调用的需求,请将固定大小的输出缓冲区 (1 KB(例如) ),然后检查函数返回值。 如果方法返回S_OK,则缓冲区已包含相关数据。 如果方法返回E_OUTOFMEMORY,则 *E_OUTOFMEMORY 中的值是保存所需数据的缓冲区大小。 然后,调用方应分配一个更大的缓冲区,并继续对 方法进行第二次调用。

任何 Pscript5 呈现插件都支持此方法。

有关详细信息,请参阅 使用 GetOptionAttribute

要求

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

另请参阅

DEVOBJ

IPrintCorePS2

IPrintCorePS2::EnumOptions

IPrintCorePS2::GetFeatureAttribute

IPrintCorePS2::GetGlobalAttribute