D2D1CreateDeviceContext function (d2d1_1.h)

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

Syntax

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

Parameters

[in] dxgiSurface

The DXGI surface the Direct2D device context is associated with.

[in, optional] creationProperties

The properties to apply to the Direct2D device context.

[out] 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.

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

See also

D2D1CreateDevice

D2D1CreateDeviceContext

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory