ID3D12Resource::ReadFromSubresource メソッド (d3d12.h)

CPU を使用してサブリソースからデータをコピーし、CPU が未定義のレイアウトを持つほとんどのテクスチャの内容を読み取できるようにします。

構文

HRESULT ReadFromSubresource(
  [out]          void            *pDstData,
                 UINT            DstRowPitch,
                 UINT            DstDepthPitch,
                 UINT            SrcSubresource,
  [in, optional] const D3D12_BOX *pSrcBox
);

パラメーター

[out] pDstData

型: void*

メモリ内の宛先データへのポインター。

DstRowPitch

型: UINT

宛先データの 1 行から次の行までの距離。

DstDepthPitch

型: UINT

宛先データの 1 つの深度スライスから次のデータまでの距離。

SrcSubresource

型: UINT

読み取るサブリソースのインデックスを指定します。

[in, optional] pSrcBox

型: const D3D12_BOX*

リソース データのコピー元となるコピー先サブリソースの部分を定義するボックスへのポインター。 NULL の場合、データはオフセットなしで宛先サブリソースから読み取られます。 変換先のディメンションは、変換先に合っている必要があります ( 「D3D12_BOX」を参照)。

空のボックスを使用すると、操作が不要になります。 上の値が下の値以上であるか、左の値が右の値以上であるか、前面の値が戻り値以上の場合、ボックスは空です。 ボックスが空の場合、このメソッドは操作を実行しません。

戻り値

種類: HRESULT

このメソッドは、Direct3D 12リターン コードのいずれかを返します。

解説

WriteToSubresource の「解説」セクションを参照してください。

要件

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

関連項目

ID3D12Resource

サブリソース