Auf Englisch lesen

Freigeben über


MxdcGetPDEVAdjustment-Funktion (mxdc.h)

Die MxdcGetPDEVAdjustment-Funktion wird von einer Druckerschnittstellen-DLL exportiert und stellt Druckerkonfigurationsdaten für den Microsoft XPS Document Converter (MXDC) bereit.

Syntax

HRESULT MxdcGetPDEVAdjustment(
  [in]           HANDLE                    hPrinter,
  [in]           ULONG                     cbDevMode,
  [in]           const DEVMODE             *pDevMode,
  [in]           ULONG                     cbIn,
  [in, optional] const VOID                *pvIn,
  [in]           ULONG                     cbPrintPropertiesCollection,
                 PrintPropertiesCollection *pPrintPropertiesCollection
);

Parameter

[in] hPrinter

Das Handle des derzeit instanziierten Druckers.

[in] cbDevMode

Die Größe der DEVMODE-Struktur in Bytes, einschließlich der privaten DEVMODE-Daten des Treibers.

[in] pDevMode

Eine Kopie der DEVMODE-Struktur, die das MXDC empfangen hat. Die Druckerschnittstellen-DLL verwendet Informationen aus dieser Struktur, um die angeforderten Daten zurückzugeben.

[in] cbIn

Ein Eingabeparameter, der die Größe des pvIn-Parameters in Bytes angibt. Dieser Parameter wird derzeit nicht verwendet, und sein Wert ist null.

[in, optional] pvIn

Ein Parameter, der aus Daten besteht, die vom MXDC an die DLL der Druckerschnittstelle gesendet werden. Dieser Parameter wird derzeit nicht verwendet, und sein Wert ist NULL.

[in] cbPrintPropertiesCollection

Die Größe der PrintPropertiesCollection-Datenstruktur in Bytes.

pPrintPropertiesCollection

Die PrintPropertiesCollection-Datenstruktur , aus der die DLL der Druckerschnittstelle die angeforderten Daten abruft. Diese Struktur ist in WinSpool.h definiert. Die angeforderten Felder sind möglicherweise bereits mit den Standarddaten des MXDC ausgefüllt. Die DLL der Druckerschnittstelle muss die Felder ignorieren, die sie nicht versteht.

Rückgabewert

MxdcGetPDEVAdjustment sollte einen der folgenden Werte zurückgeben:

Rückgabecode Beschreibung
S_OK Die DLL der Druckerschnittstelle hat basierend auf der angegebenen DEVMODE-Struktur erfolgreich einen angepassten bildbaren Bereich, komprimierungstyp oder DPI zurückgegeben. Das MXDC überprüft den zurückgegebenen bildbaren Bereich und verwendet ihn dann, um die GDIINFO-Struktur in die entsprechenden Felder aufzufüllen.
E_NOTIMPL Die MxdcGetPDEVAdjustment-Funktion wird nicht von der Druckerschnittstelle implementiert. Die Druckerschnittstelle darf die Felder, die nicht unterstützt werden, nicht ändern. Das MXDC verwendet standardmäßig die aktuellen Standardwerte. Für den Bildbereichsfall verwendet MXDC standardmäßig die physische Seitengröße. Für die Komprimierungsoption verwendet MXDC standardmäßig eine mittlere JPEG-Komprimierung.
E_FAIL Für diesen Wert oder andere Fehlerwerte gibt der MXDC -1 an die DrvEnablePDEV-Funktion zurück, fängt die interne Ausnahme ab und legt ein Flag fest, um den Druckauftrag zu fehlschlagen und zu beenden.

Hinweise

Die MxdcGetPDEVAdjustment-Funktion wird vom Hardwarehersteller implementiert. Das MXDC ruft diese Funktion auf, um Druckerkonfigurationsdaten in Form eines Eigenschaftenbehälters abzurufen, der die folgenden Daten enthält:

MXDC ermöglicht es der Druckerschnittstellen-DLL, dpi über die MxdcGetPDEVAdjustment-Funktion nur dann anzupassen, wenn das Feld dmPrintQuality des Druckauftrags einen Wert aufweist, der kleiner oder gleich 0 ist. Wenn der DPI-Wert nicht angepasst wird, ordnet MXDC negative dmPrintQuality-Werte den folgenden Auflösungen zu.

GDI-Name (Wingdi.h) GDI-Wert(Wingdi.h) MXDC-Standardinterpretation (Punkte pro Zoll)
DMRES_HIGH –4 2400
DMRES_MEDIUM -3 1200
DMRES_LOW -2 600
DMRES_DRAFT -1 400

Der Name der MXDC-Eigenschaft, die den MXDC-Standardwert dpi-Wert speichert, lautet L"MxdcDotsPerInch".

In der folgenden Tabelle sind die Eigenschaftentypen und Eigenschaftenbehälterfelder des MXDC für die Eigenschaften aufgeführt:

Property (propertyName) Eigenschaftstyp (ePropertyValue) Eigenschaftenbehälterfelder
L"MxdcImageableArea" kPropertyTypeBuffer PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyBlob.cbBuf = sizeof(RECT) PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyBlob.pBuf
L"MxdcImageCompressionType" kPropertyTypeInt32 PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyInt32
L"MxdcDotsPerInch" kPropertyTypeInt32 PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyInt32
L"MxdcLandscapeRotation" kPropertyTypeInt32 PrintPropertiesCollection::p ropertiesCollection[i].propertyValue.value.propertyInt32

In der folgenden Tabelle sind die vom MXDC unterstützten Datentypen und Datenwerte für die Eigenschaften aufgeführt:

Property (propertyName) Datentypen und Werte
L"MxdcImageableArea" Datentyp: RECT

Werte:

RECT::left (identisch mit FORM_INFO_1)

RECT::right (identisch mit FORM_INFO_1)

RECT::top (identisch mit FORM_INFO_1)

RECT::bottom (identisch mit FORM_INFO_1)
L"MxdcImageCompressionType" Datentyp: LONG

Werte:

1 = JPEG High Compression

2 = MITTLERE JPEG-Komprimierung

3 = JPEG Low Compression

4 = PNG-Komprimierung
L"MxdcDotsPerInch" Datentyp: LONG

Werte:

Ein positiver Wert für Dots Per Inch
L"MxdcLandscapeRotation" Datentyp: LONG

Werte:

90 = MXDC_LANDSCAPE_ROTATE_COUNTERCLOCKWISE_90_DEGREES

0 = MXDC_LANDSCAPE_ROTATE_NONE

-90 = MXDC_LANDSCAPE_ROTATE_COUNTERCLOCKWISE_270_DEGREES

Die MxdcGetPDEVAdjustment-Funktion ist kein Teil des MXDC. Das MXDC ruft diese Funktion in der Konfigurations-DLL des Treibers zurück, um Daten zum Konfigurieren des Druckers abzurufen.

Das MXDC erwartet, dass der bildbare Bereich in nichtrotierten Koordinaten (Hochformat) ausgedrückt wird. Der MXDC dreht sowohl die Seitengröße als auch den bildbaren Bereich entsprechend dem Wert des dmOrientation-Elements der DEVMODE-Struktur, auf die pDevMode verweist. Daher sollte die Implementierung von MxdcGetPDEVAdjustment durch den Hardwarehersteller vermeiden, den bildbaren Bereich in gedrehten Koordinaten (Querformat) anzugeben, da dies dazu führt, dass Querformatdruckaufträge falsch gedruckt werden.

Der Standardwert im MXDC ist MXDC_LANDSCAPE_ROTATE_COUNTERCLOCKWISE_270_DEGREES, was dem aktuellen Legacyverhalten entspricht.

Die gesamte Drehung erfolgt auf dem bildbaren Bereich. Wenn eine Konfigurationskomponente (UniDrv/PostScript, XPSDrv Monolithic) die neuen Eigenschaftenbehälterwerte nicht versteht, sollte sie sie ignorieren, wie es im aktuellen Entwurf der Fall ist.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile mxdc.h (mxdc.h einschließen)

Weitere Informationen

DrvEnablePDEV

GDIINFO

IPrintOemUIMXDC-Schnittstelle