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

# ReadGDSX (família XBOX One)

> Lê dados do GDS.

Lê dados do Global Data Share (GDS).

## Sintaxe

```cpp theme={null}
void ReadGDSX(  
         UINT OffsetDwords,  
         UINT NumDwords,  
         D3D12_GPU_VIRTUAL_ADDRESS pValues,  
         D3D12XBOX_GDS_OPERATION Flags  
)  
```

### Parâmetros

*OffsetDwords*   \_In\_\
Tipo: UINT

O deslocamento, em DWORDs, a partir do endereço 0 no GDS.

*NumDwords*   \_In\_\
Tipo: UINT

A quantidade máxima de GDS, em DWORDs, que o sombreador pode usar.

*pValues*   \_Inout\_\
Tipo: [D3D12\_GPU\_VIRTUAL\_ADDRESS](https://learn.microsoft.com/en-us/windows/win32/direct3d12/d3d12_gpu_virtual_address)

Ponteiro de destino para os dados do GDS. O título deve acompanhar o tempo de vida desse ponteiro e garantir que ele esteja mapeado para a memória da GPU quando a GPU gravar o conteúdo do GDS nele.

*Flags*   \_In\_\
Tipo: [D3D12XBOX\_GDS\_OPERATION](/pt-BR/reference/graphics/d3d12_x/enums/d3d12xbox_gds_operation)

Opções de cópia, como uma combinação com OR bit a bit das constantes de enumeração **D3D12XBOX\_GDS\_OPERATION**(d3d12xbox\_gds\_operation.md).

### Valor retornado

Tipo: void

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Biblioteca:** d3d12\_x.lib

**Plataformas compatíveis:** família XBOX One

## Confira também

[ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)\
[WriteGDSX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_writegdsx)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [ReadFromSubresource](/pt-BR/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_readfromsubresource_public.md)
- [SHAPE_DMA_READ_WRITE_FULL](/pt-BR/reference/audio/shapedmacontext/structs/shape_dma_read_write_full.md)
- [SetShapePcmReadPointer](/pt-BR/reference/audio/shapepcmcontext/functions/setshapepcmreadpointer.md)
- [IncrementShapeDmaReadPointer](/pt-BR/reference/audio/shapedmacontext/functions/incrementshapedmareadpointer.md)