共用方式為

DrvSplDeviceCaps 函式 （winddiui.h）

  • 發行項

印表機介面 DLL 的 DrvSplDeviceCaps 函式會查詢印表機的功能。

語法

DWORD DrvSplDeviceCaps(
                  HANDLE   hPrinter,
  [in]            PWSTR    pszDeviceName,
                  WORD     Capability,
  [out, optional] PVOID    pOutput,
                  DWORD    cchBufSize,
  [in, optional]  PDEVMODE pDevmode
);

參數

hPrinter

為印表機提供呼叫端的句柄。

[in] pszDeviceName

呼叫端提供的 Unicode 字串指標，其中包含印表機名稱。

Capability

呼叫端提供的位旗標，表示要查詢的功能。 （旗標定義於頭文件 wingdi.h.）此函式不需要支援所有 DC_XXX 旗標，但必須支援下表所列的旗標。

旗 定義
DC_MEDIAREADY pOutput 參數會指向函式應該填入字元串緩衝區陣列的緩衝區，長度每 64 個字元。 每個陣列元素都應該包含NULL終止的字串，代表可供使用的紙張表單名稱。 函式的傳回值應該是傳回數位列中的項目數。 如果 pOutputNULL，則函式應該只會傳回所需的陣列元素數目。
DC_PAPERNAMES pOutput 參數會指向函式應該填入字元串緩衝區陣列的緩衝區，長度每 64 個字元。 每個陣列元素都應該包含NULL終止的字串，代表紙張表單的名稱。 函式的傳回值應該是傳回數位列中的項目數。 如果 pOutputNULL，則函式應該只會傳回所需的陣列元素數目。

[out, optional] pOutput

呼叫端提供的緩衝區指標，該緩衝區會接收函式提供的資訊。 緩衝區的使用取決於 Capability 參數的值。 呼叫端負責配置和釋放此緩衝區。

cchBufSize

pOutput 參數所指向之緩衝區的呼叫端提供大小（以字元為單位）。

[in, optional] pDevmode

描述目前列印作業特性之 DEVMODEW 結構的呼叫端提供的指標。 如果 NULL，函式應該使用驅動程式的內部預設 DEVMODEW 結構。

傳回值

傳回值取決於 Capability 參數。 如果 功能 表示驅動程式不支援的功能，或遇到錯誤，則函式應該會傳回GDI_ERROR。

言論

如需 DC_XXX 旗標的描述，請參閱 DrvDeviceCapabilities。

此函式必須在 .def 檔案中定義為DrvSplDeviceCaps @ 254，因為多任務緩衝處理器使用序數 254 來取得驅動程式函式指標。

要求

要求 價值
目標平臺 桌面
標頭 winddiui.h （包括 Winddiui.h）

另請參閱

DrvDeviceCapabilities