ID3D12DebugCommandList1::AssertResourceState メソッド (d3d12sdklayers.h)

指定された状態がサブリソースの状態と一致することを検証します。コマンド リストの記録中に特定のサブリソースの状態が既知であると仮定します (たとえば、リソースは同じコマンド リスト記録で以前に切り替えられました)。 状態がまだ不明な場合、このメソッドは、同じコマンド リスト記録で後でさらに検証するために既知の状態を設定します。

構文

BOOL AssertResourceState(
  [in] ID3D12Resource *pResource,
       UINT           Subresource,
       UINT           State
);

パラメーター

[in] pResource

種類: ID3D12Resource*

チェックする ID3D12Resource を指定します。

Subresource

型: UINT

チェックするサブリソースのインデックス。 これは、インデックスに設定することも、D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCESすることもできます。

State

型: UINT

チェックする状態を指定します。 これは、1 つ以上 のD3D12_RESOURCE_STATES フラグまたは 1 つ以上のフラグを一緒に使用できます。

戻り値

種類: BOOL

このメソッドは、リソースまたはサブリソースの追跡された状態が指定された状態と一致する場合は true を返し、それ以外の場合 は false を 返します。

注釈

コマンド リストの実行は記録後に行われることがあるため、多くの場合、コマンド リストの記録中にリソースの状態を認識できません。 AssertResourceState を使用すると、アプリケーション開発者は、コマンド リスト内の固定記録ポイントでリソースまたはサブリソースに想定された状態を設定できます。

多くの場合、リソースまたはサブリソースの状態は、以前のバリアが原因で認識されるか、コマンド リストの記録中に (たとえば、 CopyBufferRegion の以前の呼び出しで使用された) 推論されます。 このような場合、 AssertResourceState は、指定された状態が既知または想定された状態と一致しない場合にデバッグ メッセージを生成できます。

この API はデバッグ検証専用であり、リソースの実際のランタイムまたは GPU 状態には影響しません。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	d3d12sdklayers.h

こちらもご覧ください

ID3D12DebugCommandList1