IPrintOemUni3::SetBandSize-Methode (prcomoem.h)

Artikel
03/14/2023

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.

Wert	Bedeutung
BMF_1BPP	Monochrom
BMF_4BPP	4 Bits pro Pixel
BMF_8BPP	8 Bits pro Pixel
BMF_16BPP	16 Bits pro Pixel
BMF_24BPP	24 Bits pro Pixel
BMF_32BPP	32 Bits pro Pixel
BMF_4RLE	4 Bits pro Pixel; Ausführungslänge codiert
BMF_8RLE	8 Bits pro Pixel; Ausführungslänge codiert

[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:

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt. Siehe Hinweis.
E_FAIL	Fehler beim Vorgang. Siehe Hinweis.
E_NOTIMPL	Unidrv sollte die Bandgröße berechnen.

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

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prcomoem.h (einschließlich Prcomoem.h)

Freigeben über