Compartilhar via


Método ID2D1Factory::CreateWicBitmapRenderTarget(IWICBitmap*,constD2D1_RENDER_TARGET_PROPERTIES&,ID2D1RenderTarget**) (d2d1.h)

Cria um destino de renderização que renderiza para um bitmap do Componente de Imagem do Microsoft Windows (WIC).

Sintaxe

HRESULT CreateWicBitmapRenderTarget(
  [in]  IWICBitmap                            *target,
  [ref] const D2D1_RENDER_TARGET_PROPERTIES & renderTargetProperties,
  [out] ID2D1RenderTarget                     **renderTarget
);

Parâmetros

[in] target

Tipo: IWICBitmap*

O bitmap que recebe a saída de renderização do destino de renderização.

[ref] renderTargetProperties

Tipo: const D2D1_RENDER_TARGET_PROPERTIES

O modo de renderização, o formato de pixel, as opções de comunicação remota, as informações de DPI e o suporte mínimo do DirectX necessário para a renderização de hardware. Para obter informações sobre formatos de pixel com suporte, consulte Formatos de pixel com suporte e modos alfa.

[out] renderTarget

Tipo: ID2D1RenderTarget**

Quando esse método retorna, contém o endereço do ponteiro para o objeto ID2D1RenderTarget criado por esse método.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Você deve usar D2D1_FEATURE_LEVEL_DEFAULT para o membro minLevel do parâmetro renderTargetProperties com esse método.

Seu aplicativo deve criar destinos de renderização uma vez e mantê-los durante a vida útil do aplicativo ou até que o erro D2DERR_RECREATE_TARGET seja recebido. Ao receber esse erro, você precisa recriar o destino de renderização (e todos os recursos que ele criou).

Observação

Esse método não tem suporte no Windows Phone e falhará quando chamado em um dispositivo com código de erro 0x8899000b ("Não há nenhum dispositivo de renderização de hardware disponível para esta operação"). Como o Emulador Windows Phone dá suporte à renderização WARP, esse método falhará quando chamado no emulador com um código de erro diferente, 0x88982f80 (wincodec_err_unsupportedpixelformat).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d2d1.h
Biblioteca D2d1.lib
DLL D2d1.dll

Confira também

ID2D1Factory