> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SetShapeXmaSampleRate(SHAPE_XMA_CONTEXT*, UINT32)

> SetShapeXmaSampleRate(SHAPE_XMA_CONTEXT*, UINT32)

# SetShapeXmaSampleRate(SHAPE\_XMA\_CONTEXT\*, UINT32)

Define a taxa de amostragem.

## Sintaxe

```cpp theme={null}
HRESULT SetShapeXmaSampleRate(  
         SHAPE_XMA_CONTEXT* context,  
         UINT32 sampleRate  
)  
```

### Parâmetros

*context*   \_Inout\_\
Tipo: [SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/structs/shape_xma_context.md)\*

Ponteiro para um objeto [SHAPE\_XMA\_CONTEXT](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/structs/shape_xma_context.md).

*sampleRate*   \
Tipo: UINT32

A taxa de amostragem, em hertz.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

## Comentários

O parâmetro *sampleRate* é convertido em um membro da enumeração [SHAPE\_XMA\_SAMPLE\_RATE](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/enums/shape_xma_sample_rate.md), conforme mostrado na tabela a seguir.

| Valor | Membro |
| - | - |
| \<= 24000 | SHAPE\_XMA\_SAMPLE\_RATE\_24K |
| 24001-32000 | SHAPE\_XMA\_SAMPLE\_RATE\_32K |
| 32001-44100 | SHAPE\_XMA\_SAMPLE\_RATE\_44\_1K |
| >= 44101 | SHAPE\_XMA\_SAMPLE\_RATE\_48K |

Para definir a taxa de amostragem usando um membro da enumeração [SHAPE\_XMA\_SAMPLE\_RATE](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/enums/shape_xma_sample_rate.md) em vez de um inteiro, use [SetShapeXmaSampleRate(SHAPE\_XMA\_CONTEXT\*, SHAPE\_XMA\_SAMPLE\_RATE)](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/functions/setshapexmasamplerate.md).

Para obter a taxa de amostragem atual, use [GetShapeXmaSampleRate](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/functions/getshapexmasamplerate.md).

Para obter mais informações, confira a seção [XMA](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/shape-overview.md#ID4EYD) de [Visão geral do SHAPE](https://docs.xbox.com/pt-BR/build/console-features/audio/overviews/shape-overview.md).

## Requisitos

**Cabeçalho:** shapexmacontext.h

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[ShapeXmaContext](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/shapexmacontext_members.md)


## Related topics

- [SetShapeXmaSampleRate(SHAPE_XMA_CONTEXT*, SHAPE_XMA_SAMPLE_RATE)](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/functions/setshapexmasamplerate.md)
- [SHAPE_XMA_SAMPLE_RATE](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/enums/shape_xma_sample_rate.md)
- [GetShapeXmaSampleRate](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/functions/getshapexmasamplerate.md)
- [ShapeXmaContext](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/shapexmacontext_members.md)
- [SetShapeXmaOutputBuffer(SHAPE_XMA_CONTEXT*, void*)](https://docs.xbox.com/pt-BR/reference/audio/shapexmacontext/functions/setshapexmaoutputbuffer.md)