IPrintOemPS2::GetPDEVAdjustment-Methode (prcomoem.h)

Artikel
02/07/2025

Mit der IPrintOemPS2::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_PAPER_MARGIN_TYPE	Passen Sie die Einstellung für den Papierrand an, die im PDEV angegeben wird. Siehe PDEV_ADJUST_PAPER_MARGIN Struktur.
PDEV_HOSTFONT_ENABLED_TYPE	Aktivieren oder deaktivieren Sie das Hostfont-Unterstützungsfeature. Siehe PDEV_HOSTFONT_ENABLED Struktur.
PDEV_USE_TRUE_COLOR_TYPE	Aktivieren oder deaktivieren Sie die Farbausgabe für Monochrom- und Farbdrucker. Siehe PDEV_USE_TRUE_COLOR 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 IPrintOemPS2::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 XP und höher verfügbar.

Derzeit ruft der Pscript5-Treiber IPrintOemPS2::GetPDEVAdjustment auf, um die Einstellung für den Papierrand anzupassen, wie im PDEV angegeben, um das Hostfont-Feature zu aktivieren oder zu deaktivieren, oder um die PostScript-Farbausgabe ein- oder auszuschalten.