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

# SetShapePcmAudioBuffer

> SetShapePcmAudioBuffer

# SetShapePcmAudioBuffer

Define o buffer de áudio PCM.

Esta é uma função sobrecarregada que aceita um endereço físico. [SetShapePcmAudioBuffer](/pt-BR/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer) aceita um ponteiro virtual.

## Sintaxe

```cpp theme={null}
HRESULT SetShapePcmAudioBuffer(  
         SHAPE_PCM_CONTEXT* context,  
         APU_ADDRESS audioBuffer  
)  
```

### Parâmetros

*context*   \_Inout\_\
Tipo: [SHAPE\_PCM\_CONTEXT\*](/pt-BR/reference/audio/shapepcmcontext/structs/shape_pcm_context)

Ponteiro para uma estrutura [SHAPE\_PCM\_CONTEXT](/pt-BR/reference/audio/shapepcmcontext/structs/shape_pcm_context).

*audioBuffer*   \_In\_\
Tipo: APU\_ADDRESS

Endereço físico do buffer de áudio. O alinhamento depende do tipo de buffer e do formato.

### Valor retornado

Tipo: HRESULT

Código de sucesso ou erro HRESULT.

## Comentários

O bloco Sample Rate Convertor (SRC) lê dados Pulse Code Modulation (PCM) de ponto fixo de 16, 24 ou 32 bits ou de ponto flutuante de 32 bits da memória do sistema e executa a conversão de taxa de amostragem baseada em inteiros. Os dados de saída são gravados em buffers de mixagem. Como dados de entrada, o bloco SRC pode receber a saída do decodificador de hardware XBOX Media Audio (XMA) ou dados mantidos por software. O bloco SRC tem integração estreita com o decodificador XMA. Isso permite que o bloco SRC determine se o buffer de decodificação XMA tem amostras suficientes de dados PCM decodificados sem ler a memória principal

Um processo de SRC normalmente é usado para emulação de instrumentos musicais, conversão de amostras de entrada para uma oitava abaixo ou acima da origem ou efeitos como o efeito Doppler.

O SRC opera no modo mono ou estéreo. Os dados PCM são lidos da memória e convertidos em um formato comum de ponto fixo de 24 bits para a conversão de taxa de amostragem. A saída é gravada em um ou dois buffers de mixagem, dependendo do modo. Os dados estéreo são armazenados na memória como um fluxo intercalado de dados de 16 bits, com o canal esquerdo nos 16 bits menos significativos de cada palavra de 32 bits e o canal direito nos 16 bits mais significativos. No modo estéreo, os dados PCM são lidos e desintercalados simultaneamente. Os dados do canal esquerdo (amostras de número par) são processados e enviados para um buffer de mixagem, e os dados do canal direito (amostras de número ímpar) são gravados em um segundo buffer de mixagem.

## Requisitos

**Cabeçalho:** shapepcmcontext.h

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

## Confira também

[Visão geral do ACP](/pt-BR/build/console-features/audio/overviews/acp-overview)\
[Visão geral do SHAPE](/pt-BR/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/pt-BR/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [SetShapePcmAudioBuffer](/zh-CN/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer_2.md)
- [SetShapePcmAudioBuffer function](/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)
- [SetShapePcmAudioBuffer 函数](/zh-CN/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)
- [Función SetShapePcmAudioBuffer](/es/reference/audio/shapepcmcontext/functions/setshapepcmaudiobuffer.md)