Método IXpsRasterizationFactory::CreateRasterizer (xpsrassvc.h)

O método CreateRasterize cria um objeto rasterizador XPS.

Sintaxe

HRESULT CreateRasterizer(
  [in, optional]  IXpsOMPage            *xpsPage,
  [in]            FLOAT                 DPI,
  [in]            XPSRAS_RENDERING_MODE nonTextRenderingMode,
  [in]            XPSRAS_RENDERING_MODE textRenderingMode,
  [out, optional] IXpsRasterizer        **ppIXPSRasterizer
);

Parâmetros

[in, optional] xpsPage

Ponteiro para um objeto IXpsOMPage que representa a página fixa XPS a ser renderizada. Esse objeto encapsula uma seção FixedPage de um documento XPS. Para obter mais informações, consulte IXpsOMPage.

[in] DPI

Pontos por polegada na saída rasterizada. Esse parâmetro se aplica às dimensões x e y do bitmap de saída. O valor de DPI é a resolução do dispositivo que deve imprimir ou exibir a página fixa XPS.

[in] nonTextRenderingMode

Modo de renderização para itens nontext na saída rasterizada. Esse parâmetro indica se a saída suavizada deve ser gerada. Defina esse parâmetro como um dos seguintes valores de enumeração XPSRAS_RENDERING_MODE :

• XPSRAS_RENDERING_MODE_ANTIALIASED

• XPSRAS_RENDERING_MODE_ALIASED

[in] textRenderingMode

Modo de renderização para texto na saída rasterizada. Esse parâmetro indica se a saída suavizada deve ser gerada. Defina esse parâmetro como um dos seguintes valores de enumeração XPSRAS_RENDERING_MODE:

• XPSRAS_RENDERING_MODE_ANTIALIASED

• XPSRAS_RENDERING_MODE_ALIASED

[out, optional] ppIXPSRasterizer

Esse parâmetro aponta para um local no qual o método grava um ponteiro para a interface IXpsRasterizer do objeto rasterizador XPS recém-criado. Se o método falhar, ele gravará NULL nesse local e retornará um código de erro.

Retornar valor

CreateRasterizer retornará S_OK se a chamada tiver sido bem-sucedida. Caso contrário, o método retornará um código de erro.

Os possíveis valores retornados por erro incluem:

Código de retorno	Descrição
E_POINTER	O parâmetro xpsPage ou ppIXPSRasterizer é NULL
E_INVALIDARG	O parâmetro nonTextRenderingMode ou textRenderingMode não é válido XPSRAS_RENDERING_MODE valor de enumeração.
E_OUTOFMEMORY	Memória insuficiente

Comentários

Esse método tem suporte no Windows 7 e posterior.

Normalmente, um filtro XPSDrv em um pipeline XPS chama esse método para obter um rasterizador XPS. Em seguida, ele usa o rasterizador para rasterizar a página fixa XPS encapsulada pelo objeto ao qual o parâmetro xpsPage aponta.

O parâmetro DPI especifica a resolução da impressora, que é considerada a mesma nas dimensões horizontal e vertical. A largura e a altura da página fixa XPS, que podem ser obtidas do método IXpsOMPage::GetPageDimensions, são expressas em unidades de 1/96 polegadas. Multiplique esses valores de largura e altura por DPI/96 para determinar a largura e a altura, em pixels, da página rasterizada. Para obter mais informações sobre IXpsOMPage::GetPageDimensions, consulte IXpsOMPage. Para obter mais informações sobre como o objeto rasterizador XPS usa o valor DPI, consulte IXpsRasterizer::RasterizeRect.

Se tiver êxito, o método criará um objeto rasterizador XPS e passará ao chamador uma referência contada à interface IXpsRasterizer do objeto. Quando o objeto não é mais necessário, o chamador é responsável por liberar o objeto chamando o método Release na interface IXpsRasterizer do objeto.

Se o método falhar e ppIXPSRasterizer não for NULL, o método definirá *ppIXPSRasterizer = NULL.

Para obter um exemplo de código que chama o método CreateRasterizer , consulte o exemplo XPSRasFilter no WDK. Este exemplo está localizado na pasta Src\Print\Xpsrasfilter na instalação do WDK.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 7 e versões posteriores do sistema operacional Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	xpsrassvc.h

Confira também

IXpsRasterizationFactory

IXpsRasterizer

IXpsRasterizer::RasterizeRect

XPSRAS_RENDERING_MODE