ID3D12Device::CopyDescriptorsSimple メソッド (d3d12.h)

ソースからコピー先に記述子をコピーします。

構文

void CopyDescriptorsSimple(
  [in] UINT                        NumDescriptors,
  [in] D3D12_CPU_DESCRIPTOR_HANDLE DestDescriptorRangeStart,
  [in] D3D12_CPU_DESCRIPTOR_HANDLE SrcDescriptorRangeStart,
  [in] D3D12_DESCRIPTOR_HEAP_TYPE  DescriptorHeapsType
);

パラメーター

[in] NumDescriptors

型: UINT

コピーする記述子の数。

[in] DestDescriptorRangeStart

種類: D3D12_CPU_DESCRIPTOR_HANDLE

コピーを開始する宛先記述子を記述する D3D12_CPU_DESCRIPTOR_HANDLE 。

宛先記述子とソース記述子は、同じ D3D12_DESCRIPTOR_HEAP_TYPEのヒープ内にある必要があります。

[in] SrcDescriptorRangeStart

種類: D3D12_CPU_DESCRIPTOR_HANDLE

コピーを開始するソース記述子を記述する D3D12_CPU_DESCRIPTOR_HANDLE 。

重要

SrcDescriptorRangeStart パラメーターは、シェーダーに表示されない記述子ヒープ内に存在する必要があります。 これは、シェーダーに表示される記述子ヒープが WRITE_COMBINE メモリまたは GPU ローカル メモリに作成される可能性があるためです。これは、読み取りが非常に遅いためです。 アプリケーションが、特定のパスまたはフレームに必要な記述子をローカルの "ストレージ" 記述子ヒープから GPU バインド記述子ヒープにコピーして記述子ヒープを管理する場合は、ストレージ ヒープにシェーダー不透明ヒープを使用し、必要に応じて GPU 可視ヒープにコピーします。

[in] DescriptorHeapsType

種類: D3D12_DESCRIPTOR_HEAP_TYPE

コピーする記述子ヒープの種類を指定する、 D3D12_DESCRIPTOR_HEAP_TYPE型指定された値。 これは、記述子の種類によってサイズが異なる場合があるため、必須です。

ソース記述子ヒープと宛先記述子ヒープの両方が同じ型である必要があります。それ以外の場合、デバッグ レイヤーはエラーを出力します。

戻り値

なし

解説

該当する場合は、このメソッドを ID3D12Device::CopyDescriptors よりも優先します。 コピーの線形性により、CPU キャッシュのミス率が向上する可能性があります。

要件

対象プラットフォーム	Windows
ヘッダー	d3d12.h
Library	D3D12.lib
[DLL]	D3D12.dll

関連項目

記述子のコピー

ID3D12Device