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

# XGTextureAddressComputer::CopyFromSubresource

> XGTextureAddressComputer::CopyFromSubresource (consoles XBOX Series) — Copia os dados 2D ou 3D do (consulte xgtextureaddresscomputer_copyfromsubresource_xs)

Copia os dados 2D ou 3D do sub-recurso especificado (mip + fatia) do recurso para um destino linear.

## Sintaxe

```cpp theme={null}
HRESULT CopyFromSubresource(  
         VOID* pLinearData,  
         UINT32 Plane,  
         UINT32 Subresource,  
         UINT32 Sample,  
         const VOID* pTiledResourceBaseAddress,  
         UINT32 RowPitchBytes,  
         UINT32 SlicePitchBytes  
)  
```

### Parâmetros

*pLinearData*   \_Inout\_\
Tipo: VOID\*

O local para o qual os dados serão copiados.

*Plane*   \_In\_\
Tipo: UINT32

O plano.

*Subresource*   \_In\_\
Tipo: UINT32

O sub-recurso do qual copiar.

*Sample*   \_In\_\
Tipo: UINT32

O índice da amostra da qual copiar.

*pTiledResourceBaseAddress*   \_In\_\
Tipo: VOID\*

O endereço base do recurso lado a lado do qual copiar, como um ponteiro para VOID. Para a preparação de textura offline, *pTiledResourceBaseAddress* não precisa estar alinhado corretamente.

*RowPitchBytes*   \_In\_\
Tipo: UINT32

O pitch de linha linear de destino, em bytes.

*SlicePitchBytes*   \_In\_\
Tipo: UINT32

O pitch de fatia linear de destino, em bytes.

### Valor retornado

Tipo: HRESULT

Retorna S\_OK se tiver êxito; caso contrário, retorna um código de erro. Para obter uma lista de códigos de erro, consulte [Códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

Esse método copia os dados de entrada lineares 2D ou 3D do sub-recurso especificado (mip + fatia) do recurso usando *pTiledResourceBaseAddress* como o endereço base do recurso. Para a preparação de textura offline, *pTiledResourceBaseAddress* não precisa estar alinhado corretamente.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xg\_xs.h

**Biblioteca:** xg\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[XGTextureAddressComputer](/pt-BR/reference/graphics/xg_xs/interfaces/XGTextureAddressComputer/xgtextureaddresscomputer_xs)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [D3D12_TEXTURE_COPY_TYPE](/pt-BR/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public.md)
- [D3D12_TEXTURE_COPY_LOCATION](/pt-BR/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public.md)
- [D3D12_PLACED_SUBRESOURCE_FOOTPRINT](/pt-BR/reference/graphics/d3d12/structs/d3d12_placed_subresource_footprint_public.md)
- [D3D12_BOX](/pt-BR/reference/graphics/d3d12/structs/d3d12_box_public.md)