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

# SetShapeXmaSampleRate(SHAPE_XMA_CONTEXT*, UINT32)

> SetShapeXmaSampleRate(SHAPE_XMA_CONTEXT*, UINT32)

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

Define a taxa de amostragem.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*context*   \_Inout\_\
Tipo: [SHAPE\_XMA\_CONTEXT](/pt-BR/reference/audio/shapexmacontext/structs/shape_xma_context)\*

Ponteiro para um objeto [SHAPE\_XMA\_CONTEXT](/pt-BR/reference/audio/shapexmacontext/structs/shape_xma_context).

*sampleRate*   \
Tipo: UINT32

A taxa de amostragem, em hertz.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Código de sucesso ou de erro HRESULT.

<a id="remarksSection" />

## Comentários

O parâmetro *sampleRate* é convertido em um membro da enumeração [SHAPE\_XMA\_SAMPLE\_RATE](/pt-BR/reference/audio/shapexmacontext/enums/shape_xma_sample_rate), 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](/pt-BR/reference/audio/shapexmacontext/enums/shape_xma_sample_rate) em vez de um inteiro, use [SetShapeXmaSampleRate(SHAPE\_XMA\_CONTEXT\*, SHAPE\_XMA\_SAMPLE\_RATE)](/pt-BR/reference/audio/shapexmacontext/functions/setshapexmasamplerate).

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

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

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** shapexmacontext.h

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

<a id="seealsoSection" />

## Confira também

[ShapeXmaContext](/pt-BR/reference/audio/shapexmacontext/shapexmacontext_members)


## Related topics

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