Metodo IPrintOemUni3::SetBandSize (prcomoem.h)

  • Articolo

Il IPrintOemUni3::SetBandSize metodo può essere usato con le 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ò avere 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 di esecuzione codificata
BMF_8RLE
 8 bit per pixel; lunghezza di 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, espressa 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 completata. Vedere la nota.
E_FAIL
 Operazione non riuscita. Vedere la nota.
E_NOTIMPL
 Unidrv deve calcolare le dimensioni di banda.

Commenti

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, invece di usare i calcoli delle dimensioni della banda di Unidrv.

È possibile disabilitare le operazioni di banda 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", IPrintOemUni3::SetBandSize non viene chiamato.

Se questo metodo è definito e il file GPD (Generic Printer Description) 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 Preanalysis Infrastructure.For information about the PreAnalysisOptions attribute, see Preanalysis Infrastructure.

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

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione prcomoem.h (include Prcomoem.h)