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

> Utilise le processeur pour copier des données à partir d'une sous-ressource, ce qui permet au processeur de lire le contenu de la plupart des textures dont la disposition n'est pas définie.

Utilise le processeur pour copier des données à partir d'une sous-ressource, ce qui permet au processeur de lire le contenu de la plupart des textures dont la disposition n'est pas définie.

## Syntaxe

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

### Paramètres

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

Pointeur vers les données de destination en mémoire.

*DstRowPitch*\
Type : UINT

Distance entre une ligne de données de destination et la ligne suivante.

*DstDepthPitch*\
Type : UINT

Distance entre une tranche de profondeur de données de destination et la suivante.

*SrcSubresource*\
Type : UINT

Spécifie l'index de la sous-ressource à partir de laquelle lire.

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

Pointeur vers une zone qui définit la partie de la sous-ressource de destination à partir de laquelle copier les données de la ressource.
Si NULL, les données sont lues à partir de la sous-ressource de destination sans décalage.
Les dimensions de la destination doivent tenir dans la destination (voir
[D3D12\_BOX](/fr/reference/graphics/d3d12/structs/d3d12_box_public)).

Une zone vide n'entraîne aucune opération.
Une zone est vide si la valeur top est supérieure ou égale à la valeur bottom, si la valeur left est supérieure ou égale à la valeur right, ou si la valeur front est supérieure ou égale à la valeur back.
Lorsque la zone est vide, cette méthode n'effectue aucune opération.

### Valeur de retour

Type : HRESULT

Cette méthode retourne l'un des [codes de retour Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Remarques

Consultez la section Remarques de [WriteToSubresource](/fr/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_writetosubresource_public).

## Configuration requise

**En-tête :** d3d12\_xs.h ou d3d12\_x.h\
**Bibliothèque :** d3d12\_xs.lib ou d3d12\_x.lib\
**Plateformes prises en charge :** consoles XBOX Series et famille XBOX One

## Voir aussi

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

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


## Related topics

- [D3D12_BOX](/fr/reference/graphics/d3d12/structs/d3d12_box_public.md)
- [ResolveSubresourceRegion](/fr/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_resolvesubresourceregion_public.md)
- [D3D12_SUBRESOURCE_INFO](/fr/reference/graphics/d3d12/structs/d3d12_subresource_info_public.md)
- [D3D12_SUBRESOURCE_DATA](/fr/reference/graphics/d3d12/structs/d3d12_subresource_data_public.md)
- [D3D12_SUBRESOURCE_TILING](/fr/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public.md)
