IPrintOemUIMXDC::AdjustDPI 方法 (prcomoem.h)

方法 IPrintOemUIMXDC::AdjustDPI 可讓 XPS 篩選管線驅動程式使用 UnidrvUI.dll 或 PS5UI.dll 來支援影像解析度的設定。

語法

HRESULT AdjustDPI(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PLONG          pDPI
);

參數

hPrinter

目前正在查詢之印表機的句柄。

cbDevMode

DEVMODE 結構的大小,包括附加的數據。

pDevMode

包含目前裝置設定之 DEVMODE 結構的指標。

cbOEMDM

DEVMODE 結構之廠商提供的區段中的位元組數目。

pOEMDM

PDevMode 指向之 DEVMODE 結構之廠商部分內含之數據的指標。

pDPI

目前解析度的指標,以每英吋點為單位, (DPI) ,假設為平方圖元。 如果已設定此參數,則其傳回的值必須是正整數。

傳回值

AdjustDPI 如果方法成功,則會傳回S_OK。 否則,如果外掛程式不支援 方法,則這個方法應該傳回E_NOTIMPL,如果外掛程式無法完成作業,則傳回任何適當的失敗值。 如需詳細資訊,請參閱接下來的<備註>一節。

備註

pDPI 參數為 IN OUT。 此函式的所有其他參數都是輸入。

如果外掛程式無法完成作業,它應該會傳回適當的失敗 HRESULT,這會導致目前的列印作業失敗。

規格需求

需求
最低支援的用戶端 適用於 Windows Vista 和更新版本的 Unidrvui.dll 和 Ps5ui.dll,可轉散發套件。 如果您已安裝 XPS Essentials Pack,這個方法也適用於 Microsoft Windows XP 中的 XPSDrv 驅動程式。
目標平台 桌面
標頭 prcomoem.h (包括 Prcomoem.h)