> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ReadFromSubresource

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

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

## 構文

```cpp theme={null}
HRESULT ReadFromSubresource(
    void  pDstData,
    UINT DstRowPitch,
    UINT DstDepthPitch,
    UINT SrcSubresource,
    const D3D12_BOX  pSrcBox
)
```

### パラメーター

*pDstData \[out]*\
型: void \*

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

*DstRowPitch*\
型: UINT

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

*DstDepthPitch*\
型: UINT

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

*SrcSubresource*\
型: UINT

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

*pSrcBox \[in, optional]*\
型: const D3D12\_BOX \*

リソース データのコピー元となる宛先サブリソースの部分を定義するボックスへのポインター。
NULL の場合、オフセットなしで宛先サブリソースからデータが読み取られます。
宛先の寸法は宛先に収まる必要があります ([D3D12\_BOX](/reference/graphics/d3d12/structs/d3d12_box_public) を参照)。

空のボックスは no-op になります。
top 値が bottom 値以上、または left 値が right 値以上、または front 値が back 値以上の場合、ボックスは空です。
ボックスが空の場合、このメソッドは何の操作も実行しません。

### 戻り値

型: HRESULT

このメソッドは、[Direct3D 12 のリターン コード](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues) のいずれかを返します。

## 解説

[WriteToSubresource](/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_writetosubresource_public) の「解説」セクションを参照してください。

## 要件

**ヘッダー:** d3d12\_xs.h または d3d12\_x.h\
**ライブラリ:** d3d12\_xs.lib または d3d12\_x.lib\
**サポートされているプラットフォーム**: XBOX Series 本体および XBOX One ファミリ

## 関連項目

[ID3D12Resource](/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)

[サブリソース](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/subresources)


## Related topics

- [D3D12_BOX](/ja-jp/reference/graphics/d3d12/structs/d3d12_box_public.md)
- [ResolveSubresourceRegion](/ja-jp/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_resolvesubresourceregion_public.md)
- [D3D12_SUBRESOURCE_DATA](/ja-jp/reference/graphics/d3d12/structs/d3d12_subresource_data_public.md)
- [D3D12_SUBRESOURCE_INFO](/ja-jp/reference/graphics/d3d12/structs/d3d12_subresource_info_public.md)
- [D3D12_SUBRESOURCE_FOOTPRINT](/ja-jp/reference/graphics/d3d12/structs/d3d12_subresource_footprint_public.md)