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 |