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 结构的 Attributes 成员。

[out] pData

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

[in] nSize

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

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

如果该值小于 size of (PRINTPROCESSOR_CAPS_1) ，则 winprint 打印处理器将提供 size 为 (PRINTPROCESSOR_CAPS_2) 的值。

[out] pcbNeeded

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

返回值

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

注解

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

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

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

函数应始终使用 由印刷机 指向的位置返回所需的缓冲区大小，而不管实际缓冲区是否足够大。

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

要求

要求	值
目标平台	桌面
标头	winsplp.h (包括 Winsplp.h)