Skip to main content
コマンド アロケーターに関連付けられているメモリを再利用することを示します。

構文

パラメーター

戻り値

型: HRESULT コマンド アロケーターを参照するアクティブに記録中のコマンド リストがある場合、このメソッドは E_FAIL を返します。この場合、デバッグ レイヤーもエラーを発行します。 その他の可能な戻り値については、Direct3D 12 リターン コード を参照してください。

解説

アプリは Reset を呼び出して、コマンド アロケーターに関連付けられているメモリを再利用します。この Reset の呼び出しから、ランタイムとドライバーは、グラフィックス プロセッシング ユニット (GPU) がコマンド アロケーターでコマンドを記録したコマンド リストを実行していないと判断します。 ID3D12GraphicsCommandList::Reset とは異なり、コマンド リストがまだ実行されている間にコマンド アロケーターで Reset を呼び出すことは推奨されません。 アロケーターにコマンドを記録したコマンド リストに対する保留中の GPU 参照がないことを証明できない場合、デバッグ レイヤーは警告を発行します。 Reset が (同じアロケーター オブジェクトに対して) 複数のスレッドから同時に呼び出された場合、デバッグ レイヤーはエラーを発行します。

D3D12HelloTriangle サンプルは、次のように ID3D12CommandAllocator::Reset を使用します。
D3D12 リファレンスのサンプル コード を参照してください。

要件

ヘッダー: d3d12_xs.h または d3d12_x.h
ライブラリ: d3d12_xs.lib または d3d12_x.lib
サポートされるプラットフォーム: XBOX Series 本体および XBOX One ファミリ

関連項目

ID3D12CommandAllocator
最終更新日 2026年8月24日