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


Функция 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 Description
S_OK Ошибка не произошла.
E_OUTOFMEMORY Direct2D не удалось выделить достаточно памяти для завершения вызова.
E_INVALIDARG Недопустимое значение было передано методу.

Замечания

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

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

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

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

Требования

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

См. также

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory