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

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

構文

void CopyDescriptors(
  [in]           UINT                              NumDestDescriptorRanges,
  [in]           const D3D12_CPU_DESCRIPTOR_HANDLE *pDestDescriptorRangeStarts,
  [in, optional] const UINT                        *pDestDescriptorRangeSizes,
  [in]           UINT                              NumSrcDescriptorRanges,
  [in]           const D3D12_CPU_DESCRIPTOR_HANDLE *pSrcDescriptorRangeStarts,
  [in, optional] const UINT                        *pSrcDescriptorRangeSizes,
  [in]           D3D12_DESCRIPTOR_HEAP_TYPE        DescriptorHeapsType
);

パラメーター

[in] NumDestDescriptorRanges

型: UINT

コピー先の記述子範囲の数。

[in] pDestDescriptorRangeStarts

型: const D3D12_CPU_DESCRIPTOR_HANDLE*

コピー先の D3D12_CPU_DESCRIPTOR_HANDLE オブジェクトの配列。

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

[in, optional] pDestDescriptorRangeSizes

型: const UINT*

コピー先の記述子範囲サイズの配列。

[in] NumSrcDescriptorRanges

型: UINT

コピー元のソース記述子範囲の数。

[in] pSrcDescriptorRangeStarts

型: const D3D12_CPU_DESCRIPTOR_HANDLE*

コピー元の D3D12_CPU_DESCRIPTOR_HANDLE オブジェクトの配列。

[in, optional] pSrcDescriptorRangeSizes

型: const UINT*

コピー元のソース記述子範囲サイズの配列。

[in] DescriptorHeapsType

種類: D3D12_DESCRIPTOR_HEAP_TYPE

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

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

戻り値

なし

解説

必要に応じて、このメソッドよりも ID3D12Device::CopyDescriptorsSimple を使用します。 コピーの線形的な性質により、CPU キャッシュ ミス率が向上する可能性があります。

要件

こちらもご覧ください

記述子のコピー

ID3D12Device