> ## 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

> Usa a CPU para copiar dados de um sub-recurso, permitindo que a CPU leia o conteúdo da maioria das texturas com layouts indefinidos.

Usa a CPU para copiar dados de um sub-recurso, permitindo que a CPU leia o conteúdo da maioria das texturas com layouts indefinidos.

## Sintaxe

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

### Parâmetros

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

Um ponteiro para os dados de destino na memória.

*DstRowPitch*\
Tipo: UINT

A distância de uma linha de dados de destino até a próxima linha.

*DstDepthPitch*\
Tipo: UINT

A distância de uma fatia de profundidade de dados de destino até a próxima.

*SrcSubresource*\
Tipo: UINT

Especifica o índice do sub-recurso do qual ler.

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

Um ponteiro para uma caixa que define a parte do sub-recurso de destino da qual copiar os dados do recurso.
Se for NULL, os dados serão lidos do sub-recurso de destino sem deslocamento.
As dimensões do destino devem caber no destino (consulte
[D3D12\_BOX](/pt-BR/reference/graphics/d3d12/structs/d3d12_box_public)).

Uma caixa vazia resulta em nenhuma operação.
Uma caixa está vazia se o valor superior for maior ou igual ao valor inferior, ou se o valor esquerdo for maior ou igual ao valor direito, ou se o valor frontal for maior ou igual ao valor traseiro.
Quando a caixa está vazia, este método não executa nenhuma operação.

### Valor retornado

Tipo: HRESULT

Este método retorna um dos [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Consulte a seção Comentários de [WriteToSubresource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_writetosubresource_public).

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[ID3D12Resource](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs)

[Sub-recursos](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/subresources)


## Related topics

- [D3D12_BOX](/pt-BR/reference/graphics/d3d12/structs/d3d12_box_public.md)
- [ResolveSubresourceRegion](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_resolvesubresourceregion_public.md)
- [Map](/pt-BR/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [D3D12_SUBRESOURCE_DATA](/pt-BR/reference/graphics/d3d12/structs/d3d12_subresource_data_public.md)
- [D3D12_SUBRESOURCE_FOOTPRINT](/pt-BR/reference/graphics/d3d12/structs/d3d12_subresource_footprint_public.md)