ID3D12GraphicsCommandList::D iscardResource メソッド (d3d12.h)

リソースの内容を保持する必要がしないことを示します。場合によっては、この関数によってリソースメタデータが再初期化される場合があります。

構文

void DiscardResource(
  ID3D12Resource             *pResource,
  const D3D12_DISCARD_REGION *pRegion
);

pResource

リソースが破棄する ID3D12Resource インターフェイスへのポインター。

pRegion

型: [in, optional] const D3D12_DISCARD_REGION*

破棄リソース操作の詳細を記述する D3D12_DISCARD_REGION 構造体へのポインター。

なし

DiscardResource のセマンティクスは、コマンドリストの種類に基づいて変更されます。

D3D12_COMMAND_LIST_TYPE_DIRECTでは、次の 2 つの規則が適用されます。

リソースに D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET フラグがある場合、破棄されたサブリソース領域がD3D12_RESOURCE_STATE_RENDER_TARGET リソースバリア状態にある場合は、DiscardResource を呼び出す必要があります。
リソースに D3D12_RESOURCE_FLAG _ALLOW_DEPTH_STENCIL フラグがある場合は、破棄されたサブ リソース 領域が D3D12_RESOURCE_STATE_DEPTH_WRITEにあるときに DiscardResource を呼び出す必要があります。

D3D12_COMMAND_LIST_TYPE_COMPUTEでは、次の規則が適用されます。

リソースには D3D12_RESOURCE_FLAG_ALLOW_UNORDERED_ACCESS フラグが必要です。破棄されたサブリソース領域がリソースバリア状態D3D12_RESOURCE_STATE_UNORDERED_ACCESS場合は、DiscardResource を呼び出す必要があります。

DiscardResource は、D3D12_COMMAND_LIST_TYPE_BUNDLEまたはD3D12_COMMAND_LIST_TYPE_COPYのコマンドリストではサポートされていません。