IPrintOemUni3::SetBandSize-Methode (prcomoem.h)

Die IPrintOemUni3::SetBandSize Methode kann mit von Unidrv unterstützten Druckern verwendet werden, um die gewünschte Bandgröße auf der gedruckten Ausgabe anzugeben.

Syntax

HRESULT SetBandSize(
  [in] PDEVOBJ pdevobj,
  [in] INT     iFormat,
  [in] DWORD   dwPageWidthBytes,
  [in] DWORD   dwPageHeight,
  [in] DWORD   dwMaxHeight,
  [in] PDWORD  pdwRequiredHeight
);

Parameter

[in] pdevobj

Ein vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ-Struktur .

[in] iFormat

Ein ganzzahliger Wert, der das Format der Bitmap in Bezug auf die Anzahl der Bits von Farbinformationen pro Pixel angibt, die erforderlich sind. Dieser Parameter kann einen der folgenden Werte annehmen.

[in] dwPageWidthBytes

Ein von Unidrv bereitgestellter Wert, der die Breite des Druckbereichs in Bytes angibt.

[in] dwPageHeight

Ein von Unidrv bereitgestellter Wert, der die Höhe des Druckbereichs in Pixel angibt.

[in] dwMaxHeight

Ein von Unidrv bereitgestellter Wert, der die maximal zulässige Höhe des Druckbereichs in Pixel angibt.

[in] pdwRequiredHeight

Ein vom Aufrufer bereitgestellter Zeiger auf ein DWORD, das die Höhe des Druckbereichs in Pixel enthält, die für das Rendering-Plug-In erforderlich ist.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben:

Hinweise

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

Diese Methode wird von einem Rendering-Plug-In verwendet, um die Bandgröße mithilfe der eigenen Berechnungen des Plug-Ins anzugeben, anstatt die Bandgrößenberechnungen von Unidrv zu verwenden.

Sie können Bandingvorgänge von Unidrv deaktivieren, indem Sie den dwPageHeight-Wert auf *pdwRequiredHeight festlegen. Sie sollten jedoch den Leistungseffekt des Vom Rendering-Plug-In angeforderten Höhenwerts berücksichtigen. Zum Rendern benötigt Unidrv mindestens die Arbeitsspeichermenge, die durch Multiplikation von dwPageWidthBytes mit *pdwRequiredHeight berechnet wird. Wenn das Rendering-Plug-In die IPrintOemUni::D riverDMS-Methode unterstützt und diese Methode "S_OK" zurückgibt, IPrintOemUni3::SetBandSize wird nicht aufgerufen.

Wenn diese Methode definiert ist und die GPD-Datei (Generic Printer Description) des Druckers angibt, dass die Voranalyse deaktiviert ist (die GPD-Datei enthält "*PreAnalysisOptions: 0"), ruft Unidrv diese Methode auf, um die Bandgröße zu berechnen. Informationen zum PreAnalysisOptions-Attribut finden Sie unter Präanalyseinfrastruktur.

Wenn das Rendering-Plug-In IPrintOemUni::D riverDMS unterstützt und diese Methode S_OK zurückgibt, IPrintOemUni3::SetBandSize wird nicht aufgerufen.

Anforderungen