D2D1CreateDevice function (d2d1_1.h)

Creates a new Direct2D device associated with the provided DXGI device.

Syntax

HRESULT D2D1CreateDevice(
  [in]           IDXGIDevice                    *dxgiDevice,
  [in, optional] const D2D1_CREATION_PROPERTIES *creationProperties,
  [out]          ID2D1Device                    **d2dDevice
);

Parameters

[in] dxgiDevice

The DXGI device the Direct2D device is associated with.

[in, optional] creationProperties

The properties to apply to the Direct2D device.

[out] d2dDevice

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

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.

If the creation properties are not specified, then d2dDevice will inherit its threading mode from dxgiDevice and debug tracing will not be enabled.

Requirements

Requirement Value
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

D2D1CreateFactory

D2D1_CREATION_PROPERTIES

ID2D1Device

ID2D1Factory

ID2D1Resource::GetFactory