ID2D1DeviceContext：：GetTarget 方法 (d2d1_1.h)

获取当前与设备上下文关联的目标。

语法

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

参数

[out, optional] image

类型： ID2D1Image**

此方法返回时，包含指向当前与设备上下文关联的目标的指针的地址。

返回值

无

备注

如果目标未与设备上下文关联，则当方法返回时 ，目标 将包含 NULL 。

如果当前选定的目标是位图而不是命令列表，则应用程序可以访问使用以下方法之一创建的初始位图：

• CreateHwndRenderTarget
• CreateDxgiSurfaceRenderTarget
• CreateWicBitmapRenderTarget
• CreateDCRenderTarget
• CreateCompatibleRenderTarget

应用程序无法销毁这些位图。 所有这些位图都可以绑定为位图目标。 但是，并非所有这些位图都可以用作 ID2D1RenderTarget 方法的位图源。

如果 DXGI 图面可绑定为着色器资源视图，CreateDxgiSurfaceRenderTarget 将创建一个位图，该位图可作为位图源使用。

CreateCompatibleRenderTarget 将始终创建可用作位图源的位图。

ID2D1RenderTarget：：BeginDraw 将从 HDC 复制到与其关联的原始位图。 ID2D1RenderTarget：：EndDraw 将从原始位图复制到 HDC。

在以下情况下，IWICBitmap 对象将被锁定：

• 已调用 BeginDraw，当前选定的目标位图为 WIC 位图。
• 在调用 BeginDraw 之后和调用 EndDraw 之前，将 WIC 位图设置为设备上下文的目标。
• 使用 WIC 位图作为源或目标调用任何 ID2D1Bitmap：：Copy* 方法。

在以下情况下，IWICBitmap 对象将解锁：

• 调用 EndDraw，当前选定的目标位图为 WIC 位图。
• 在对 BeginDraw 和 EndDraw 的调用之间，将删除 WIC 位图作为设备上下文的目标。
• 使用 WIC 位图作为源或目标调用任何 ID2D1Bitmap：：Copy* 方法。

Direct2D 将仅锁定当前未锁定的位图。

调用 ID2D1GdiInteropRenderTarget 的 QueryInterface 将始终成功。 ID2D1GdiInteropRenderTarget：：GetDC 将返回对应于当前绑定目标位图的设备上下文。 如果未使用设置GDI_COMPATIBLE标志创建目标位图，则 GetDC 将失败。

ID2D1HwndRenderTarget：：Resize 将返回 DXGI_ERROR_INVALID_CALL ，如果存在与呈现目标关联的原始目标位图的任何未完成引用。

尽管目标可以是命令列表，但它不能是任何其他类型的图像。 它不能是效果的输出图像。

要求

要求	值
最低受支持的客户端	适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d2d1_1.h
DLL	D2d1.dll

另请参阅

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext：：CreateBitmap

ID2D1DeviceContext::SetTarget