Metodo IPrintOemUni3::SetBandSize (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintOemUni3::SetBandSize può essere utilizzato con stampanti supportate da Unidrv per specificare le dimensioni della banda desiderate nell'output stampato.

Sintassi

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

Parametri

[in] pdevobj

Puntatore fornito dal chiamante a una struttura DEVOBJ.

[in] iFormat

Valore intero che specifica il formato della bitmap in termini di numero di bit di informazioni sul colore per pixel necessarie. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
BMF_1BPP	Monocromatico
BMF_4BPP	4 bit per pixel
BMF_8BPP	8 bit per pixel
BMF_16BPP	16 bit per pixel
BMF_24BPP	24 bit per pixel
BMF_32BPP	32 bit per pixel
BMF_4RLE	4 bit per pixel; lunghezza esecuzione codificata
BMF_8RLE	8 bit per pixel; lunghezza esecuzione codificata

[in] dwPageWidthBytes

Valore fornito da Unidrv che specifica la larghezza dell'area di stampa, espressa in byte.

[in] dwPageHeight

Valore fornito da Unidrv che specifica l'altezza dell'area di stampa, in pixel.

[in] dwMaxHeight

Valore fornito da Unidrv che specifica l'altezza massima consentita dell'area di stampa, espressa in pixel.

[in] pdwRequiredHeight

Puntatore fornito dal chiamante a un DWORD che contiene l'altezza dell'area di stampa, in pixel, richiesta dal plug-in di rendering.

Valore restituito

Il metodo deve restituire uno dei valori seguenti:

Codice restituito	Descrizione
S_OK	Operazione riuscita. Vedere La nota.
E_FAIL	Operazione non riuscita. Vedere La nota.
E_NOTIMPL	Unidrv deve calcolare le dimensioni di banda.

Osservazioni

Questo metodo è disponibile in Windows Vista e versioni successive.

Questo metodo viene usato da un plug-in di rendering per specificare le dimensioni della banda usando i calcoli personalizzati del plug-in, anziché i calcoli delle dimensioni della banda unidrv.

È possibile disabilitare le operazioni di banding da Unidrv impostando il valore dwPageHeight su *pdwRequiredHeight, ma è consigliabile considerare l'effetto delle prestazioni del valore di altezza richiesto dal plug-in di rendering. Per il rendering, Unidrv richiede almeno la quantità di memoria calcolata moltiplicando dwPageWidthBytes per *pdwRequiredHeight. Se il plug-in di rendering supporta il metodo IPrintOemUni::D riverDMS e tale metodo restituisce "S_OK", non viene chiamato IPrintOemUni3::SetBandSize.

Se questo metodo è definito e il file di descrizione della stampante generica (GPD) della stampante indica che la preanalisi è disabilitata (il file GPD include "*PreAnalysisOptions: 0"), Unidrv chiama questo metodo per calcolare le dimensioni della banda. Per informazioni sull'attributo PreAnalysisOptions, vedere Dell'infrastruttura di preanalysis.

Se il plug-in di rendering supporta IPrintOemUni::D riverDMS e tale metodo restituisce S_OK, IPrintOemUni3::SetBandSize non viene chiamato.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Condividi tramite