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) 的值，視列印處理器支援的結構而定。

如果值小於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_datatype 格式的值名稱，其中 datatype 是輸入數據類型的名稱。 呼叫 GetPrintProcessorCapabilities 之前， 多任務緩衝處理程式會從值名稱字串中移除PrintProcCaps_前置詞。

函式應該判斷接收的緩衝區是否夠大，如果是，則應該填入 PRINTPROCESSOR_CAPS_1 或 PRINTPROCESSOR_CAPS_2 結構並傳回。 nSize 的值會決定將使用PRINTPROCESSOR_CAPS_1或PRINTPROCESSOR_CAPS_2。

函式應該一律使用 由 lbNeeded 指向的位置來傳回所需的緩衝區大小，不論實際緩衝區是否夠大。

指定的傳回值會變成多任務緩衝處理程式為 GetPrinterData 提供的傳回值。

規格需求

需求	值
目標平台	桌面
標頭	winsplp.h (包含 Winsplp.h)