IPrintOemUIMXDC::AdjustImageableArea-Methode (prcomoem.h)
Mit der IPrintOemUIMXDC::AdjustImageableArea-Methode kann ein XPS-Filterpipelinetreiber UnidrvUI.dll oder PS5UI.dll 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 zurzeit abgefragt wird.
cbDevMode
Die Größe der DEVMODE- Struktur in Byte, 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 durch UnidrvUI.dll oder PS5UI.dll mit Daten aus der entsprechenden GPD oder PPD aufgefüllt, bevor der Parameter an das Plug-In übergeben wird. Das Plug-In kann diese Daten dann aktualisieren, bevor sie zurückgegeben werden.
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 geeigneten Fehlerwert, wenn das Plug-In den Vorgang nicht abschließen kann. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Bemerkungen
Der prclImageableArea Parameter ist IN OUT. Alle anderen Parameter für diese Methode sind nur Eingaben.
Wenn das Plug-In den Vorgang nicht abschließen kann, sollte ein entsprechender HRESULT-Fehlerwert zurückgegeben werden, der dazu führt, dass der aktuelle Druckauftrag fehlschlägt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar mit Windows Vista und höheren Versionen von Unidrvui.dll und Ps5ui.dll, die weiterverteilt werden können. Diese Methode ist auch für XPSDrv-Treiber in Microsoft Windows XP verfügbar, wenn Sie das XPS Essentials Pack installiert haben. |
| Zielplattform- | Desktop |
| Header- | prcomoem.h (einschließlich Prcomoem.h) |