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

備註

延後的內容是安全線程的內容,可用來在主轉譯線程以外的線程上記錄圖形命令。 您可以使用延後的內容,將圖形命令記錄到 ID3D11CommandList 介面所封裝的命令清單中。 記錄所有場景項目之後,您就可以將它們提交至主要轉譯線程以進行最終轉譯。 如此一來,您可以跨多個線程同時執行轉譯工作,並可能改善多核心 CPU 案例中的效能。

您可以建立多個延後的內容。

注意 如果您使用 D3D11_CREATE_DEVICE_SINGLETHREADED 值來建立 ID3D11Device所代表的裝置, CreateDeferredContext 方法將會失敗,而且您將無法建立延後的內容。
 
如需延遲內容的詳細資訊,請參閱 立即和延後轉譯

Windows Phone 8:支援此 API。

規格需求

需求
目標平台 Windows
標頭 d3d11.h
程式庫 D3d11.lib

另請參閱

ID3D11Device

ID3D11Device1::CreateDeferredContext1

ID3D11Device2::CreateDeferredContext2

ID3D11Device3::CreateDeferredContext3