IPrintOemUIMXDC::AdjustImageCompression-Methode (prcomoem.h)

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.

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