> ## 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 (confira xgtextureaddresscomputer_copyfromsubresource)

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4EG" />

### Parâmetros

*pLinearData*   \_Inout\_<br />Tipo: VOID\*

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

*Plane*   \_In\_<br />Tipo: UINT32

O plano.

*Subresource*   \_In\_<br />Tipo: UINT32

O sub-recurso do qual copiar.

*pTiledResourceBaseAddress*   \_In\_<br />Tipo: VOID\*

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

*RowPitchBytes*   \_In\_<br />Tipo: UINT32

O pitch de linha, em bytes.

*SlicePitchBytes*   \_In\_<br />Tipo: UINT32

O pitch de fatia, em bytes.

<a id="ID4EP" />

### Valor retornado

Tipo: [HRESULT](https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retornará **S\_OK** se tiver êxito; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, confira [Códigos de erro](/pt-BR/reference/errorcodes).

<a id="remarks" />

## Comentários

Este 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 texturas offline, *pTiledResourceBaseAddress* não precisa estar alinhado corretamente.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xg.h

**Biblioteca:** xg\_x.lib

**Plataformas com suporte:** família XBOX One

<a id="ID4EHC" />

## Confira também

[XGTextureAddressComputer](/pt-BR/reference/graphics/xg__NR/interfaces/XGTextureAddressComputer/xgtextureaddresscomputer)<br />[Referência do XG](/pt-BR/reference/graphics/xg__NR/xg_members)


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