> ## 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 la CPU para copiar datos desde un subrecurso, lo que permite a la CPU leer el contenido de la mayoría de las texturas con diseños indefinidos.

Usa la CPU para copiar datos desde un subrecurso, lo que permite a la CPU leer el contenido de la mayoría de las texturas con diseños indefinidos.

## Sintaxis

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

### Parámetros

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

Un puntero a los datos de destino en la memoria.

*DstRowPitch*\
Tipo: UINT

La distancia de una fila de datos de destino a la siguiente fila.

*DstDepthPitch*\
Tipo: UINT

La distancia de un segmento de profundidad de datos de destino al siguiente.

*SrcSubresource*\
Tipo: UINT

Especifica el índice del subrecurso desde el que se va a leer.

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

Un puntero a un cuadro que define la parte del subrecurso de destino desde la que se van a copiar los datos del recurso.
Si es NULL, los datos se leen del subrecurso de destino sin desplazamiento.
Las dimensiones del destino deben ajustarse al destino (consulte
[D3D12\_BOX](/reference/graphics/d3d12/structs/d3d12_box_public)).

Un cuadro vacío da como resultado una operación nula.
Un cuadro está vacío si el valor top es mayor o igual que el valor bottom, o el valor left es mayor o igual que el valor right, o el valor front es mayor o igual que el valor back.
Cuando el cuadro está vacío, este método no realiza ninguna operación.

### Valor devuelto

Tipo: HRESULT

Este método devuelve uno de los [códigos devueltos de Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentarios

Consulte la sección Comentarios de [WriteToSubresource](/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_writetosubresource_public).

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

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

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


## Related topics

- [D3D12_BOX](/es/reference/graphics/d3d12/structs/d3d12_box_public.md)
- [ResolveSubresourceRegion](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_resolvesubresourceregion_public.md)
- [Map](/es/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [D3D12_SUBRESOURCE_DATA](/es/reference/graphics/d3d12/structs/d3d12_subresource_data_public.md)
- [D3D12_SUBRESOURCE_INFO](/es/reference/graphics/d3d12/structs/d3d12_subresource_info_public.md)