ID3D11Device::CreateDeferredContext 方法 (d3d11.h)

创建可记录命令列表的延迟上下文。

语法

HRESULT CreateDeferredContext(
                  UINT                ContextFlags,
  [out, optional] ID3D11DeviceContext **ppDeferredContext
);

参数

ContextFlags

类型: UINT

保留供将来使用。 传递 0。

[out, optional] ppDeferredContext

类型: ID3D11DeviceContext**

完成 方法后,将初始化指向 ID3D11DeviceContext 接口指针的传递指针。

返回值

类型: HRESULT

如果成功,则返回S_OK;否则,返回下列值之一:

  • 如果视频卡已实际从系统中删除,或者视频卡的驱动程序升级,则返回DXGI_ERROR_DEVICE_REMOVED。 如果发生此错误,应销毁并重新创建设备。
  • 如果无法从当前上下文调用 CreateDeferredContext 方法,则返回DXGI_ERROR_INVALID_CALL。 例如,如果设备是使用 D3D11_CREATE_DEVICE_SINGLETHREADED 值创建的, 则 CreateDeferredContext 将返回 DXGI_ERROR_INVALID_CALL
  • 如果 ContextFlags 参数无效,则返回E_INVALIDARG
  • 如果应用程序已耗尽可用内存,则返回 E_OUTOFMEMORY

注解

延迟上下文是线程安全的上下文,可用于在main呈现线程以外的线程上记录图形命令。 使用延迟上下文,可以将图形命令记录到 ID3D11CommandList 接口封装的命令列表中。 录制所有场景项后,即可将其提交到main呈现线程进行最终渲染。 通过这种方式,可以跨多个线程同时执行呈现任务,并有可能提高多核 CPU 方案中的性能。

可以创建多个延迟上下文。

注意 如果使用 D3D11_CREATE_DEVICE_SINGLETHREADED 值创建 ID3D11Device 表示的设备, 则 CreateDeferredContext 方法将失败,并且无法创建延迟的上下文。
 
有关延迟上下文的详细信息,请参阅 即时呈现和延迟呈现

Windows Phone 8:支持此 API。

要求

要求
目标平台 Windows
标头 d3d11.h
Library D3d11.lib

另请参阅

ID3D11Device

ID3D11Device1::CreateDeferredContext1

ID3D11Device2::CreateDeferredContext2

ID3D11Device3::CreateDeferredContext3