> ## 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 CPU pour copier des données à partir d'une sous-ressource, permettant au CPU de lire le contenu de la plupart des textures dont la disposition est non définie.

Utilise le CPU pour copier des données à partir d'une sous-ressource, permettant au CPU de lire le contenu de la plupart des textures dont la disposition est non 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

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

*DstDepthPitch*\
Type : UINT

La 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 boîte 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 correspondre à la destination (voir
[D3D12\_BOX](/fr-CA/reference/graphics/d3d12/structs/d3d12_box_public)).

Une boîte vide n'entraîne aucune opération.
Une boîte est vide si la valeur du haut est supérieure ou égale à la valeur du bas, ou si la valeur de gauche est supérieure ou égale à la valeur de droite, ou si la valeur avant est supérieure ou égale à la valeur arrière.
Lorsque la boîte 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-CA/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-CA/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-CA/reference/graphics/d3d12/structs/d3d12_box_public.md)
- [ResolveSubresourceRegion](/fr-CA/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_resolvesubresourceregion_public.md)
- [D3D12_SUBRESOURCE_DATA](/fr-CA/reference/graphics/d3d12/structs/d3d12_subresource_data_public.md)
- [D3D12_SUBRESOURCE_INFO](/fr-CA/reference/graphics/d3d12/structs/d3d12_subresource_info_public.md)
- [D3D12_SUBRESOURCE_TILING](/fr-CA/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public.md)