Método ID2D1DeviceContext::GetTarget (d2d1_1.h)

  • Artigo

Obtém o destino atualmente associado ao contexto do dispositivo.

Sintaxe

void GetTarget(
  [out, optional] ID2D1Image **image
);

Parâmetros

[out, optional] image

Tipo: ID2D1Imagem**

Quando esse método retorna, contém o endereço de um ponteiro para o destino atualmente associado ao contexto do dispositivo.

Retornar valor

Nenhum

Comentários

Se um destino não estiver associado ao contexto do dispositivo, o destino conterá NULL quando os métodos retornarem.

Se o destino atualmente selecionado for um bitmap em vez de uma lista de comandos, o aplicativo poderá obter acesso aos bitmaps iniciais criados usando um dos seguintes métodos:

Não é possível que um aplicativo destrua esses bitmaps. Todos esses bitmaps são associáveis como destinos de bitmap. No entanto, nem todos esses bitmaps podem ser usados como fontes de bitmap para métodos ID2D1RenderTarget .

CreateDxgiSurfaceRenderTarget criará um bitmap utilizável como uma fonte de bitmap se a superfície DXGI for associável como uma exibição de recurso de sombreador.

CreateCompatibleRenderTarget sempre criará bitmaps que podem ser usados como uma fonte de bitmap.

ID2D1RenderTarget::BeginDraw copiará do HDC para o bitmap original associado a ele. ID2D1RenderTarget::EndDraw copiará do bitmap original para o HDC.

Os objetos IWICBitmap serão bloqueados nas seguintes circunstâncias:

  • BeginDraw foi chamado e o bitmap de destino selecionado no momento é um bitmap WIC.
  • Um bitmap WIC é definido como o destino de um contexto de dispositivo após BeginDraw ter sido chamado e antes de EndDraw ser chamado.
  • Qualquer um dos métodos ID2D1Bitmap::Copy* é chamado com um bitmap WIC como a origem ou o destino.
Os objetos IWICBitmap serão desbloqueados nas seguintes circunstâncias:
  • EndDraw é chamado e o bitmap de destino selecionado no momento é um bitmap WIC.
  • Um bitmap wic é removido como o destino de um contexto de dispositivo entre as chamadas para BeginDraw e EndDraw.
  • Qualquer um dos métodos ID2D1Bitmap::Copy* é chamado com um bitmap WIC como a origem ou o destino.
Direct2D bloqueará apenas bitmaps que não estão bloqueados no momento.

Chamar QueryInterface para ID2D1GdiInteropRenderTarget sempre terá êxito. ID2D1GdiInteropRenderTarget::GetDC retornará um contexto de dispositivo correspondente ao bitmap de destino associado no momento. O GetDC falhará se o bitmap de destino não tiver sido criado com o sinalizador GDI_COMPATIBLE definido.

ID2D1HwndRenderTarget::Resize retornará DXGI_ERROR_INVALID_CALL se houver referências pendentes ao bitmap de destino original associado ao destino de renderização.

Embora o destino possa ser uma lista de comandos, ele não pode ser qualquer outro tipo de imagem. Não pode ser a imagem de saída de um efeito.

Requisitos

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

Confira também

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::SetTarget