Compartilhar via


Método IPrintOemUni3::SetBandSize (prcomoem.h)

O IPrintOemUni3::SetBandSize método pode ser usado com impressoras com suporte unidrv para especificar o tamanho de banda desejado na saída impressa.

Sintaxe

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

Parâmetros

[in] pdevobj

Um ponteiro fornecido pelo chamador para uma estrutura DEVOBJ .

[in] iFormat

Um valor inteiro que especifica o formato do bitmap em termos do número de bits de informações de cor por pixel necessários. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
BMF_1BPP
Monocromático
BMF_4BPP
4 bits por pixel
BMF_8BPP
8 bits por pixel
BMF_16BPP
16 bits por pixel
BMF_24BPP
24 bits por pixel
BMF_32BPP
32 bits por pixel
BMF_4RLE
4 bits por pixel; comprimento de execução codificado
BMF_8RLE
8 bits por pixel; comprimento de execução codificado

[in] dwPageWidthBytes

Um valor fornecido por Unidrv que especifica a largura da área de impressão, em bytes.

[in] dwPageHeight

Um valor fornecido por Unidrv que especifica a altura da área de impressão, em pixels.

[in] dwMaxHeight

Um valor fornecido por Unidrv que especifica a altura máxima permitida da área de impressão, em pixels.

[in] pdwRequiredHeight

Um ponteiro fornecido pelo chamador para um DWORD que contém a altura da área de impressão, em pixels, exigida pelo plug-in de renderização.

Retornar valor

O método deve retornar um dos seguintes valores:

Código de retorno Descrição
S_OK
A operação foi realizada com êxito. Consulte a observação.
E_FAIL
Falha na operação. Consulte a observação.
E_NOTIMPL
Unidrv deve calcular o tamanho da faixa.

Comentários

Esse método está disponível no Windows Vista e posterior.

Esse método é usado por um plug-in de renderização para especificar o tamanho da banda usando os próprios cálculos do plug-in, em vez de usar cálculos de tamanho de banda unidrv.

Você pode desabilitar operações de faixa por Unidrv definindo o valor dwPageHeight como *pdwRequiredHeight, mas deve considerar o efeito de desempenho do valor de altura que o plug-in de renderização solicita. Para renderização, Unidrv precisa pelo menos da quantidade de memória calculada multiplicando dwPageWidthBytes por *pdwRequiredHeight. Se o plug-in de renderização der suporte ao método IPrintOemUni::D riverDMS e esse método retornar "S_OK", IPrintOemUni3::SetBandSize não será chamado.

Se esse método for definido e o arquivo GPD (descrição da impressora genérica) da impressora indicar que a pré-análise está desabilitada (o arquivo GPD inclui "*PreAnalysisOptions: 0"), Unidrv chama esse método para calcular o tamanho da banda. Para obter informações sobre o atributo PreAnalysisOptions , consulte Preanalysis Infrastructure.

Se o plug-in de renderização der suporte a IPrintOemUni::D riverDMS e esse método retornar S_OK, IPrintOemUni3::SetBandSize não será chamado.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)