Skip to main content

Função SetShapePcmAudioBuffer

Define o buffer de áudio PCM. Esta é uma função sobrecarregada que aceita um ponteiro virtual. SetShapePcmAudioBuffer aceita um endereço físico.

Sintaxe

Parâmetros

context   _Inout_
Tipo: SHAPE_PCM_CONTEXT*
Ponteiro para uma estrutura SHAPE_PCM_CONTEXT. audioBuffer   _In_
Tipo: void*
Ponteiro para o buffer de áudio. O requisito de alinhamento depende do tipo do 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
Visão geral do SHAPE
shapepcmcontext
Last modified on October 6, 2026