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

Obtiene el destino asociado actualmente al contexto del dispositivo.

Sintaxis

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

Parámetros

[out, optional] image

Tipo: ID2D1Image**

Cuando este método vuelve, contiene la dirección de un puntero al destino asociado actualmente con el contexto del dispositivo.

Valor devuelto

None

Observaciones

Si un destino no está asociado al contexto del dispositivo, el destino contendrá NULL cuando los métodos devuelvan.

Si el destino seleccionado actualmente es un mapa de bits en lugar de una lista de comandos, la aplicación puede obtener acceso a los mapas de bits iniciales creados mediante uno de los métodos siguientes:

• CreateHwndRenderTarget
• CreateDxgiSurfaceRenderTarget
• CreateWicBitmapRenderTarget
• CreateDCRenderTarget
• CreateCompatibleRenderTarget

No es posible que una aplicación destruya estos mapas de bits. Todos estos mapas de bits se pueden enlazar como destinos de mapa de bits. Sin embargo, no todos estos mapas de bits se pueden usar como orígenes de mapa de bits para los métodos ID2D1RenderTarget .

CreateDxgiSurfaceRenderTarget creará un mapa de bits que se puede usar como origen de mapa de bits si la superficie DXGI se puede enlazar como una vista de recursos del sombreador.

CreateCompatibleRenderTarget siempre creará mapas de bits que se pueden usar como origen de mapa de bits.

ID2D1RenderTarget::BeginDraw copiará del HDC al mapa de bits original asociado. ID2D1RenderTarget::EndDraw copiará desde el mapa de bits original a HDC.

Los objetos IWICBitmap se bloquearán en las siguientes circunstancias:

• Se ha llamado a BeginDraw y el mapa de bits de destino seleccionado actualmente es un mapa de bits wic.
• Un mapa de bits WIC se establece como destino de un contexto de dispositivo después de llamar a BeginDraw y antes de llamar a EndDraw.
• Se llama a cualquiera de los métodos ID2D1Bitmap::Copy* con un mapa de bits WIC como origen o destino.

Los objetos IWICBitmap se desbloquearán en las siguientes circunstancias:

• Se llama a EndDraw y el mapa de bits de destino seleccionado actualmente es un mapa de bits WIC.
• Se quita un mapa de bits WIC como destino de un contexto de dispositivo entre las llamadas a BeginDraw y EndDraw.
• Se llama a cualquiera de los métodos ID2D1Bitmap::Copy* con un mapa de bits WIC como origen o destino.

Direct2D solo bloqueará los mapas de bits que no están bloqueados actualmente.

Llamar a QueryInterface para ID2D1GdiInteropRenderTarget siempre se realizará correctamente. ID2D1GdiInteropRenderTarget::GetDC devolverá un contexto de dispositivo correspondiente al mapa de bits de destino enlazado actualmente. GetDC producirá un error si el mapa de bits de destino no se creó con la marca GDI_COMPATIBLE establecida.

ID2D1HwndRenderTarget::Resize devolverá DXGI_ERROR_INVALID_CALL si hay referencias pendientes al mapa de bits de destino original asociado al destino de representación.

Aunque el destino puede ser una lista de comandos, no puede ser ningún otro tipo de imagen. No puede ser la imagen de salida de un efecto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 y actualización de plataforma para Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 y actualización de plataforma para Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1_1.h
Archivo DLL	D2d1.dll

Consulte también

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::SetTarget