Метод ID2D1DeviceContext::GetTarget (d2d1_1.h)

Статья
02/28/2024

Возвращает целевой объект, связанный в данный момент с контекстом устройства.

Синтаксис

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

Параметры

[out, optional] image

Тип: ID2D1Image**

При возврате этого метода содержит адрес указателя на целевой объект, связанный в данный момент с контекстом устройства.

Возвращаемое значение

None

Remarks

Если целевой объект не связан с контекстом устройства, при возврате методов целевой объект будет содержать значение NULL .

Если выбранный в данный момент целевой объект является растровым, а не списком команд, приложение может получить доступ к начальным растровым изображениям, созданным с помощью одного из следующих методов:

Приложение не может уничтожить эти растровые изображения. Все эти растровые изображения можно привязать в качестве целевых точечного рисунка. Однако не все эти растровые изображения можно использовать в качестве источников растровых изображений для методов ID2D1RenderTarget .

CreateDxgiSurfaceRenderTarget создаст растровое изображение, которое можно использовать в качестве источника растрового изображения, если поверхность DXGI привязывается в качестве представления ресурсов шейдера.

CreateCompatibleRenderTarget всегда создает растровые изображения, которые можно использовать в качестве источника растровых изображений.

ID2D1RenderTarget::BeginDraw скопирует из HDC исходное растровое изображение, связанное с ним. ID2D1RenderTarget::EndDraw будет копировать исходное растровое изображение в HDC.

Объекты IWICBitmap будут заблокированы в следующих случаях:

Метод BeginDraw был вызван, и выбранное в настоящее время целевое растровое изображение является растровым изображением WIC.
Точечный рисунок WIC устанавливается в качестве целевого объекта контекста устройства после вызова BeginDraw и до вызова EndDraw.
Любой из методов ID2D1Bitmap::Copy* вызывается с растровым изображением WIC в качестве источника или назначения.

Объекты IWICBitmap будут разблокированы в следующих случаях:

Метод EndDraw вызывается, а выбранное в настоящее время целевое растровое изображение является растровым изображением WIC.
Растровое изображение WIC удаляется в качестве целевого объекта контекста устройства между вызовами BeginDraw и EndDraw.
Любой из методов ID2D1Bitmap::Copy* вызывается с растровым изображением WIC в качестве источника или назначения.

Direct2D блокирует только точечные изображения, которые в настоящее время не заблокированы.

Вызов QueryInterface для ID2D1GdiInteropRenderTarget всегда будет успешным. ID2D1GdiInteropRenderTarget::GetDC вернет контекст устройства, соответствующий текущей привязанной целевой растровой карте. GetDC завершится ошибкой, если целевое растровое изображение не было создано с установленным флагом GDI_COMPATIBLE.

ID2D1HwndRenderTarget::Resize вернет DXGI_ERROR_INVALID_CALL , если с целевым объектом отрисовки связаны какие-либо незавершенные ссылки на исходное целевое растровое изображение.

Хотя целевой объект может быть списком команд, он не может быть любым другим типом изображения. Он не может быть выходным изображением эффекта.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 и обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d2d1_1.h
DLL	D2d1.dll

См. также раздел

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::SetTarget

Поделиться через