IPrintOemUIMXDC::AdjustImageCompression-Methode (prcomoem.h)

Artikel
08/07/2023

Die IPrintOemUIMXDC::AdjustImageCompression Methode ermöglicht es einem XPS-Filterpipelinetreiber, UnidrvUI.dll oder PS5UI.dll zu verwenden, um die Konfiguration der Komprimierungsebene für JPEG- oder PNG-Bilder zu unterstützen.

Syntax

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

Parameter

hPrinter

Ein Handle für den Drucker, der derzeit 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.

pCompressionMode

Ein Zeiger auf die aktuelle Komprimierungsebene. pCompressionMode ist ein in Mxdc.h angegebenen Enumerationstyp.

Rückgabewert

AdjustImageCompression 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

Die IPrintOemUIMXDC::AdjustImageCompression Methode wirkt sich auf JPEG- und PNG-Bilder aus, die von Microsoft XPS Document Converter (MXDC) generiert werden. Die IPrintOemUIMXDC::AdjustImageCompression Methode wirkt sich nicht auf die JPEG- und PNG-Bilder aus, die von Anwendungen direkt über den GDI JPEG/PNG-Bildpassthroughmechanismus (BMF_JPEG, BMF_PNG) an GDI gesendet werden.

Die Kerntreiber, UnidrvUI.dll und PS5UI.dll, ändern die Einstellungen für die Bildkomprimierung nicht. Das Plug-In kann jedoch den Wert ändern, der dem MXDC vom GDI-Druckpfad ursprünglich bereitgestellt wird.

Der pCompressionMode-Parameter verfügt über einen der folgenden vordefinierten Werte.

ENUM-Typ	Wert	Bedeutung
MXDC_IMAGETYPE_JPEGHIGH_COMPRESSION	1	Niedrigste Qualität und kleinste Dateigröße
MXDC_IMAGETYPE_JPEGMEDIUM_COMPRESSION	2	Mittlere Qualität und mittlere Dateigröße
MXDC_IMAGETYPE_JPEGLOW_COMPRESSION	3	Hohe Qualität und große Dateigröße
MXDC_IMAGETYPE_PNG	4	Höchste Qualität und größte Dateigröße

Der pCompressionMode-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 entsprechendes 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 (einschließlich Prcomoem.h)

Freigeben über