D2D1CreateDeviceContext function

Creates a new Direct2D device context associated with a DXGI surface.

Syntax

HRESULT D2D1CreateDeviceContext(
  IDXGISurface                   *dxgiSurface,
  const D2D1_CREATION_PROPERTIES *creationProperties,
  ID2D1DeviceContext             **d2dDeviceContext
);

Parameters

dxgiSurface

The DXGI surface the Direct2D device context is associated with.

creationProperties

The properties to apply to the Direct2D device context.

d2dDeviceContext

When this function returns, contains the address of a pointer to a Direct2D device context.

Return Value

The function returns an HRESULT. Possible values include, but are not limited to, those in the following table.

HRESULT Description
S_OK No error occurred.
E_OUTOFMEMORY Direct2D could not allocate sufficient memory to complete the call.
E_INVALIDARG An invalid value was passed to the method.

Remarks

This function will also create a new ID2D1Factory1 that can be retrieved through ID2D1Resource::GetFactory.

This function will also create a new ID2D1Device that can be retrieved through ID2D1DeviceContext::GetDevice.

The DXGI device will be specified implicitly through dxgiSurface.

If creationProperties are not specified, the Direct2D device will inherit its threading mode from the DXGI device implied by dxgiSurface and debug tracing will not be enabled.

Requirements

   
Minimum supported client Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header d2d1_1.h
DLL D2d1.dll

See Also

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory