IPrintOemUni3::GetPDEVAdjustment-Methode (prcomoem.h)

Artikel
02/07/2025

Mit der IPrintOemUni3::GetPDEVAdjustment-Methode kann ein Plug-In bestimmte PDEV--Einstellungen außer Kraft setzen.

Syntax

HRESULT GetPDEVAdjustment(
        PDEVOBJ  pdevobj,
        DWORD    dwAdjustType,
        PVOID    pBuf,
        DWORD    cbBuffer,
  [out] OUT BOOL *pbAdjustmentDone
);

Parameter

pdevobj

Zeiger auf eine DEVOBJ--Struktur.

dwAdjustType

Gibt den Typ der angeforderten Anpassung an. Die folgenden Flags werden derzeit unterstützt.

Flagge	Bedeutung
PDEV_ADJUST_GRAPHICS_RESOLUTION_TYPE	Passen Sie die Grafikauflösungseinstellung an, die in der PDEV-Struktur gemeldet wird. Weitere Informationen finden Sie in der PDEV_ADJUST_GRAPHICS RESOLUTION Struktur.
PDEV_IMAGEABLE_ORIGIN_AREA_TYPE	Passen Sie den bildbaren Ursprungsbereich an, der in der PDEV-Struktur gemeldet wird. Weitere Informationen finden Sie in der PDEV_ADJUST_IMAGEABLE_ORIGIN_AREA Struktur.
PDEV_ADJUST_PHYSICAL_PAPER_SIZE_TYPE	Passen Sie das physische Papierformat an, das in der PDEV-Struktur angegeben wird. Weitere Informationen finden Sie in der PDEV_ADJUST_PAPER_PHYSICAL_SIZE Struktur.

pBuf

Zeigen Sie auf eine Struktur, die die geplanten Einstellungen enthält, die verwendet werden, wenn keine Änderung vorhanden ist. Diese Strukturen sind in der vorherigen Tabelle aufgeführt. Das Plug-In kann die Einstellungen in der relevanten Struktur überschreiben.

cbBuffer

Gibt die Größe der Struktur in Bytes an, auf die durch pBuf-verwiesen wird.

[out] pbAdjustmentDone

Zeigen Sie auf einen Speicherspeicherort, den das Plug-In auf TRUE- festlegt, wenn er tatsächlich einen Wert im Puffer ändert. Dies kann vom Treiber für Optimierungen verwendet werden.

Rückgabewert

Die IPrintOemUni3::GetPDEVAdjustment-Methode sollte S_OK zurückgeben, wenn der Anpassungstyp erkannt wird, und S_FALSE, wenn dies nicht der Fall ist. Wenn die Methode fehlschlägt, sollte sie E_FAIL zurückgeben. Die Kette der Plug-Ins wird aufgerufen, bis entweder S_OK oder ein anderer Fehlercode als E_NOTIMPL zurückgegeben wird. Das heißt, die Kette der Plug-Ins wird aufgerufen, bis das erste Plug-In, das die Anpassung verarbeiten kann, gefunden wird.

Bemerkungen

Diese Funktion ist in Windows Vista und höher verfügbar.

Derzeit ruft der Unidrv-Treiber IPrintOemUni3::GetPDEVAdjustment auf, um die Einstellung der Grafikauflösung anzupassen, wie im PDEV angegeben, um den bildfähigen Ursprungsbereich anzupassen oder das physische Papierformat anzupassen.