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


Функция D2D1CreateDeviceContext (d2d1_1.h)

Создает новый контекст устройства Direct2D, связанный с поверхностью DXGI.

Синтаксис

HRESULT D2D1CreateDeviceContext(
  [in]           IDXGISurface                   *dxgiSurface,
  [in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
  [out]          ID2D1DeviceContext             **d2dDeviceContext
);

Параметры

[in] dxgiSurface

Поверхность DXGI, с которым связан контекст устройства Direct2D.

[in, optional] creationProperties

Свойства, применяемые к контексту устройства Direct2D.

[out] d2dDeviceContext

При возврате этой функции содержит адрес указателя на контекст устройства Direct2D.

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

Функция возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

HRESULT Описание:
S_OK Без ошибок.
E_OUTOFMEMORY Direct2D не удалось выделить достаточно памяти для завершения вызова.
E_INVALIDARG В метод было передано недопустимое значение.

Комментарии

Эта функция также создаст новый объект ID2D1Factory1 , который можно получить с помощью ID2D1Resource::GetFactory.

Эта функция также создаст новый id2D1Device , который можно получить с помощью ID2D1DeviceContext::GetDevice.

Устройство DXGI будет указано неявно через dxgiSurface.

Если свойства creationProperties не указаны, устройство Direct2D наследует режим потоков от устройства DXGI, подразумеваемого dxgiSurface , и трассировка отладки не будет включена.

Требования

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

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

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory