Freigeben über


IPrintOemUIMXDC::AdjustImageableArea-Methode (prcomoem.h)

Die IPrintOemUIMXDC::AdjustImageableArea Methode ermöglicht es einem XPS-Filterpipelinetreiber, UnidrvUI.dll oder PS5UI.dll zu verwenden, um die Konfiguration des druckbaren Bereichs zu unterstützen, einschließlich Ausrichtung und Drehrichtung.

Syntax

HRESULT AdjustImageableArea(
  HANDLE         hPrinter,
  DWORD          cbDevMode,
  const PDEVMODE pDevMode,
  DWORD          cbOEMDM,
  const PVOID    pOEMDM,
  PRECTL         prclImageableArea
);

Parameter

hPrinter

Ein Handle für den Drucker, der derzeit abgefragt wird.

cbDevMode

Die Größe der DEVMODE-Struktur in Bytes, einschließlich angefügter Daten.

pDevMode

Ein Zeiger auf die DEVMODE-Struktur, die die aktuellen Geräteeinstellungen enthält.

cbOEMDM

Die Anzahl der Bytes im vom Anbieter bereitgestellten Abschnitt der DEVMODE-Struktur.

pOEMDM

Ein Zeiger auf die Daten, die im Anbieterteil der DEVMODE-Struktur enthalten sind, auf die pDevMode verweist.

prclImageableArea

Ein Zeiger auf eine RECTL-Struktur , die den druckbaren Bereich enthält. Dieser Parameter wird von UnidrvUI.dll oder PS5UI.dll mit Daten aus dem entsprechenden GPD oder PPD aufgefüllt, bevor der Parameter an das Plug-In übergeben wird. Das Plug-In kann diese Daten dann aktualisieren, bevor es zurückgegeben wird.

Rückgabewert

AdjustImageableArea gibt S_OK zurück, wenn diese Methode erfolgreich ist. Andernfalls sollte diese Methode E_NOTIMPL zurückgeben, wenn das Plug-In die -Methode nicht unterstützt, oder einen entsprechenden Fehlerwert, wenn das Plug-In den Vorgang nicht abschließen kann. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Hinweise

Der prclImageableArea-Parameter ist IN OUT. Alle anderen Parameter für diese Methode werden nur eingegeben.

Wenn das Plug-In den Vorgang nicht abschließen kann, sollte es einen entsprechenden Fehler-HRESULT-Wert zurückgeben, der zum Ausfall des aktuellen Druckauftrags führt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar mit Windows Vista und höheren Versionen von Unidrvui.dll und Ps5ui.dll, die verteilbar sind. Diese Methode ist auch für XPSDrv-Treiber in Microsoft Windows XP verfügbar, wenn Sie das XPS Essentials Pack installiert haben.
Zielplattform Desktop
Kopfzeile prcomoem.h (einschließlich Prcomoem.h)

Weitere Informationen

IPrintOemUIMXDC

RECTL