ID3D11DeviceContext：：ExecuteCommandList 方法 (d3d11.h)

將命令清單的命令排入裝置。

語法

void ExecuteCommandList(
  [in] ID3D11CommandList *pCommandList,
       BOOL              RestoreContextState
);

參數

[in] pCommandList

類型： ID3D11CommandList*

封裝命令清單的 ID3D11CommandList 介面指標。

RestoreContextState

類型： BOOL

布爾值旗標，決定是否在執行命令清單之前和還原之前儲存目標內容狀態。 使用 TRUE 表示運行時間需要儲存和還原狀態。 使用 FALSE 表示不應該儲存或還原狀態，這會導致目標內容在執行命令清單之後返回其默認狀態。 應用程式通常應該使用 FALSE ，除非它們將狀態還原為幾乎相當於傳遞 TRUE 時運行時間會還原的狀態。 當應用程式使用 FALSE 時，它們可以避免不必要的無效率狀態轉換。

傳回值

無

備註

使用此方法可播放任何線程上延遲內容所記錄的命令清單。

需要從延後的內容呼叫命令清單的 ExecuteCommandList ，才能在圖形處理單位上執行錄製命令， (GPU) 。 從延後內容到另一個延遲內容的命令清單 ExecuteCommandList 呼叫，可用來合併記錄的清單。 但是若要從 GPU 上合併的延遲命令清單執行命令，您必須在立即的內容上執行命令。

這個方法會執行與查詢相關的一些運行時間驗證。 在裝置內容中啟動的查詢無法透過執行命令清單 (間接操作，也就是 Begin 或 End 是由產生命令清單) 的延遲內容，針對相同的查詢叫用。 如果發生這類狀況，ExecuteCommandList 方法就不會執行命令清單。 不過，仍會維護裝置內容的狀態，除非應用程式指出保留裝置內容狀態，否則會如預期 (ID3D11DeviceContext：：ClearState 執行。除非應用程式指出要保留裝置內容狀態) 。

Windows Phone 8：支援此 API。

規格需求

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

另請參閱

ID3D11DeviceContext