IPrintOemUIMXDC::AdjustDPI-Methode (prcomoem.h)
Die IPrintOemUIMXDC::AdjustDPI
-Methode ermöglicht es einem XPS-Filterpipelinetreiber, UnidrvUI.dll oder PS5UI.dll zu verwenden, um die Konfiguration der Bildauflösung zu unterstützen.
Syntax
HRESULT AdjustDPI(
HANDLE hPrinter,
DWORD cbDevMode,
const PDEVMODE pDevMode,
DWORD cbOEMDM,
const PVOID pOEMDM,
PLONG pDPI
);
Parameter
hPrinter
Ein Handle für den Drucker, der gerade abgefragt wird.
cbDevMode
Die Größe der DEVMODE-Struktur , 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.
pDPI
Ein Zeiger auf die aktuelle Auflösung in Dots per Inch (DPI), wobei quadratische Pixel vorausgesetzt werden. Wenn dieser Parameter konfiguriert ist, muss der zurückgegebene Wert eine positive ganze Zahl sein.
Rückgabewert
AdjustDPI
gibt S_OK zurück, wenn die 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 pDPI-Parameter ist IN OUT. Alle anderen Parameter für diese Funktion werden nur eingegeben.
Wenn das Plug-In den Vorgang nicht abschließen kann, sollte es ein geeignetes Fehler-HRESULT zurückgeben, was dazu führt, dass der aktuelle Druckauftrag fehlschlägt.
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 (include Prcomoem.h) |