IPrintOemUIMXDC::AdjustImageableArea 方法 (prcomoem.h)
方法 IPrintOemUIMXDC::AdjustImageableArea
可讓 XPS 篩選管線驅動程式使用 UnidrvUI.dll 或 PS5UI.dll 來支援可列印區域的設定,包括旋轉方向和方向。
語法
HRESULT AdjustImageableArea(
HANDLE hPrinter,
DWORD cbDevMode,
const PDEVMODE pDevMode,
DWORD cbOEMDM,
const PVOID pOEMDM,
PRECTL prclImageableArea
);
參數
hPrinter
目前正在查詢之印表機的句柄。
cbDevMode
DEVMODE 結構的大小,以位元組為單位,包括附加的數據。
pDevMode
包含目前裝置設定之 DEVMODE 結構的指標。
cbOEMDM
DEVMODE 結構之廠商提供的區段中的位元組數目。
pOEMDM
PDevMode 指向之 DEVMODE 結構之廠商部分內含之數據的指標。
prclImageableArea
包含可列印區域的 RECTL 結構的指標。 此參數會先填入 UnidrvUI.dll 或 PS5UI.dll 對應 GPD 或 PPD 的數據,然後再將參數傳遞至外掛程式。 外掛程式接著可以在傳回之前更新此數據。
傳回值
AdjustImageableArea
如果這個方法成功,會傳回S_OK。 否則,如果外掛程式不支援 方法,則這個方法應該傳回E_NOTIMPL,如果外掛程式無法完成作業,則傳回任何適當的失敗值。 如需詳細資訊,請參閱接下來的<備註>一節。
備註
中國lImageableArea 參數為 IN OUT。 這個方法的其他所有參數都是輸入。
如果外掛程式無法完成作業,它應該會傳回適當的失敗 HRESULT 值,這會導致目前的列印作業失敗。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 和更新版本的 Unidrvui.dll 和 Ps5ui.dll,可轉散發套件。 如果您已安裝 XPS Essentials Pack,這個方法也適用於 Microsoft Windows XP 中的 XPSDrv 驅動程式。 |
目標平台 | 桌面 |
標頭 | prcomoem.h (包括 Prcomoem.h) |