IPrintOemUni3::GetPDEVAdjustment-Methode (prcomoem.h)

Artikel
08/07/2023

Die IPrintOemUni3::GetPDEVAdjustment -Methode ermöglicht es einem Plug-In, bestimmte PDEV-Einstellungen zu überschreiben.

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.

Flag	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 gemeldet wird. Weitere Informationen finden Sie in der PDEV_ADJUST_PAPER_PHYSICAL_SIZE-Struktur .

pBuf

Zeiger auf eine Struktur, die die geplanten Einstellungen enthält, die verwendet werden, wenn keine Änderungen vorgenommen werden. Diese Strukturen werden in der vorherigen Tabelle aufgeführt. Das Plug-In kann die Einstellungen in der entsprechenden Struktur überschreiben.

cbBuffer

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

[out] pbAdjustmentDone

Zeiger auf einen Speicherspeicherort, den das Plug-In auf TRUE festlegt, wenn es 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 sie den Anpassungstyp erkennt, und S_FALSE, wenn dies nicht der Fall ist. Wenn die Methode fehlschlägt, sollte sie E_FAIL zurückgeben. Die Kette von Plug-Ins wird aufgerufen, bis entweder S_OK oder ein anderer Fehlercode als E_NOTIMPL zurückgegeben wird. Das heißt, die Kette von Plug-Ins wird aufgerufen, bis das erste Plug-In gefunden wird, das die Anpassung verarbeiten kann.

Hinweise

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

Derzeit ruft der Unidrv-Treiber IPrintOemUni3::GetPDEVAdjustment auf, die Grafikauflösungseinstellung anzupassen, wie im PDEV gemeldet, um den bildbaren Ursprungsbereich anzupassen oder die physische Papiergröße anzupassen.