共用方式為

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終止的字串，代表可供使用的紙張表單名稱。 函式的傳回值應該是傳回數位中的元素數目。 如果 pOutput 為 NULL，函式應該只會傳回所需的陣列元素數目。
DC_PAPERNAMES pOutput 參數指向函式應該填入字串緩衝區陣列的緩衝區，每個長度為64個字元。 每個陣列元素都應該包含NULL終止的字串，代表紙張表單的名稱。 函式的傳回值應該是傳回數位中的元素數目。 如果 pOutput 為 NULL，函式應該只會傳回所需的陣列元素數目。

[out, optional] pOutput

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

cchBufSize

呼叫端提供的大小 (，以 pOutput 參數所指向之緩衝區的字元) 。

[in, optional] pDevmode

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

傳回值

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

備註

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

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

規格需求

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

另請參閱

DrvDeviceCapabilities