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

# SampleCountersX (família XBOX One)

> Grava os valores dos contadores de hardware da GPU em um buffer fornecido pelo usuário, em um deslocamento fornecido pelo usuário.

Grava os valores dos contadores de hardware da GPU em um buffer fornecido pelo usuário, em um deslocamento fornecido pelo usuário.

## Sintaxe

```cpp theme={null}
void SampleCountersX(  
         ID3D12GraphicsCommandList* pCommandList,  
         ID3D12Resource* pDestinationBuffer,  
         UINT64 AlignedDestinationBufferOffset  
)  
```

### Parâmetros

*pDestinationBuffer*   \_In\_\
Tipo: [ID3D12Resource\*](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12resource/id3d12resource)

O buffer fornecido pelo usuário que recebe os valores dos contadores.

*AlignedDestinationBufferOffset*   \_In\_\
Tipo: UINT64

O deslocamento (em bytes) dentro do buffer no qual os valores dos contadores são gravados.

### Valor retornado

Tipo: void

## Comentários

Esta função deve ser chamada entre [ID3D12GraphicsCommandList::StartCountersX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_startcountersx) e [ID3D12GraphicsCommandList::StopCountersX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_stopcountersx). A chamada a ID3D12GraphicsCommandList::StartCountersX determina quais contadores são recuperados. Chame [ID3D12XboxCounterSet::GetCounterDataSizeX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxcounterset/methods/id3d12xboxcounterset_getcounterdatasizex) para determinar o espaço necessário no buffer de saída. Depois que a solicitação de amostragem chegar à GPU, chame [ID3D12XboxCounterSet::RetrieveCounterDataX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxcounterset/methods/id3d12xboxcounterset_retrievecounterdatax) para recuperar os dados do buffer de volta para uma estrutura [D3D12XBOX\_COUNTER\_DATA](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_counter_data).

## Requisitos

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

**Biblioteca:** d3d12\_x.lib

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

## Confira também

[D3D12XBOX\_COUNTER\_DATA](/pt-BR/reference/graphics/d3d12_x/structs/d3d12xbox_counter_data)

[ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/id3d12graphicscommandlist)

[ID3D12GraphicsCommandList::StartCountersX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_startcountersx)

[ID3D12GraphicsCommandList::StopCountersX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_stopcountersx)

[ID3D12XboxCounterSet](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxcounterset/id3d12xboxcounterset)

[ID3D12XboxCounterSet::GetCounterDataSizeX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxcounterset/methods/id3d12xboxcounterset_getcounterdatasizex)

[ID3D12XboxCounterSet::RetrieveCounterDataX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12xboxcounterset/methods/id3d12xboxcounterset_retrievecounterdatax)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [PIXReportCounter](/pt-BR/reference/tools/pix3/functions/pixreportcounter.md)
- [SHAPE_XMA_SAMPLE_RATE](/pt-BR/reference/audio/shapexmacontext/enums/shape_xma_sample_rate.md)
- [game_chat_sample_type](/pt-BR/reference/chat/gamechat2/enums/game_chat_sample_type.md)
- [SetSamplePositions](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist1/methods/id3d12graphicscommandlist1_setsamplepositions_public.md)