ID3D11Device3::CreateDeferredContext3 method (d3d11_3.h)

Creates a deferred context, which can record command lists.

Syntax

HRESULT CreateDeferredContext3(
                  UINT                 ContextFlags,
  [out, optional] ID3D11DeviceContext3 **ppDeferredContext
);

Parameters

ContextFlags

Type: UINT

Reserved for future use. Pass 0.

[out, optional] ppDeferredContext

Type: ID3D11DeviceContext3**

Upon completion of the method, the passed pointer to an ID3D11DeviceContext3 interface pointer is initialized.

Return value

Type: HRESULT

Returns S_OK if successful; otherwise, returns one of the following:

  • Returns DXGI_ERROR_DEVICE_REMOVED if the video card has been physically removed from the system, or a driver upgrade for the video card has occurred. If this error occurs, you should destroy and recreate the device.
  • Returns DXGI_ERROR_INVALID_CALL if the CreateDeferredContext3 method can't be called from the current context. For example, if the device was created with the D3D11_CREATE_DEVICE_SINGLETHREADED value, CreateDeferredContext3 returns DXGI_ERROR_INVALID_CALL.
  • Returns E_INVALIDARG if the ContextFlags parameter is invalid.
  • Returns E_OUTOFMEMORY if the app has exhausted available memory.

Requirements

Requirement Value
Target Platform Windows
Header d3d11_3.h
Library D3D11.lib

See also

ID3D11Device1::CreateDeferredContext1

ID3D11Device2::CreateDeferredContext2

ID3D11Device3

ID3D11Device::CreateDeferredContext