通过

GetPrintProcessorCapabilities 函数 （winsplp.h）

  • 项目

打印处理器的 GetPrintProcessorCapabilities 函数返回与指定输入数据类型关联的功能。

语法

DWORD GetPrintProcessorCapabilities(
  [in]  LPTSTR  pValueName,
  [in]  DWORD   dwAttributes,
  [out] LPBYTE  pData,
  [in]  DWORD   nSize,
  [out] LPDWORD pcbNeeded
);

参数

[in] pValueName

调用方提供的指针指向表示打印处理器支持的数据类型的字符串。 字符串指针的类型必须为 LPWSTR。

[in] dwAttributes

调用方提供的属性标志。 请参阅 PRINTER_INFO_x 结构 成员 属性。

[out] pData

调用方提供的指向 PRINTPROCESSOR_CAPS_1 或 PRINTPROCESSOR_CAPS_2 结构的指针。

[in] nSize

调用方提供的值，表示由 pData指向的缓冲区的大小。

如果值小于 sizeof（PRINTPROCESSOR_CAPS_1），则此函数应提供等于 sizeof（PRINTPROCESSOR_CAPS_1） 或 sizeof（PRINTPROCESSOR_CAPS_2）的值，具体取决于打印处理器支持的结构。

如果该值小于 sizeof（PRINTPROCESSOR_CAPS_1），则 winprint 打印处理器将提供 sizeof 值（PRINTPROCESSOR_CAPS_2）。

[out] pcbNeeded

调用方提供的指向位置的指针，用于接收由 pData指向的缓冲区所需的最小大小。

返回值

如果作成功，该函数应返回ERROR_SUCCESS。 否则，它应返回 Win32 错误代码。

言论

打印处理器可以选择导出 GetPrintProcessorCapabilities 函数。 函数的目的是为打印处理器支持的每个输入数据类型返回填充PRINTPROCESSOR_CAPS_1或PRINTPROCESSOR_CAPS_2结构。

当应用程序 调用 getPrinterData时，后台处理程序调用打印处理器的 GetPrintProcessorCapabilities 函数，并指定具有PrintProcCaps_数据类型格式的值名称，其中 数据类型 是输入数据类型的名称。 在调用 GetPrintProcessorCapabilities 之前， 后台处理程序从值名称字符串中删除PrintProcCaps_前缀。

该函数应确定接收的缓冲区是否足够大，如果是，则应填写 PRINTPROCESSOR_CAPS_1 或 PRINTPROCESSOR_CAPS_2 结构并返回。 nSize 的值确定是使用 PRINTPROCESSOR_CAPS_1 还是 PRINTPROCESSOR_CAPS_2。

函数应始终使用 指向的位置返回所需的缓冲区大小，无论实际缓冲区是否足够大。

指定的返回值将成为后台处理程序为 GetPrinterData提供的返回值。

要求

要求 价值
目标平台 桌面
标头 winsplp.h （包括 Winsplp.h）