Método IXAudio2SourceVoice::SetSourceSampleRate (xaudio2.h)

Reconfigura a voz para consumir dados de origem em uma taxa de exemplo diferente da taxa especificada quando a voz foi criada.

Sintaxe

HRESULT SetSourceSampleRate(
  [in] UINT32 NewSourceSampleRate
);

Parâmetros

[in] NewSourceSampleRate

A nova taxa de exemplo em que a voz deve processar os dados enviados. As taxas de exemplo válidas são de 1kHz a 200kHz.

Retornar valor

Retorna S_OK se tiver êxito, caso contrário, um código de erro. Consulte Códigos de Erro XAudio2 para obter descrições de códigos de erro.

Comentários

O método SetSourceSampleRate dá suporte à reutilização de vozes XAudio2, permitindo que uma voz reproduza sons com uma variedade de taxas de exemplo. Para usar SetSourceSampleRate , a voz deve ter sido criada sem os sinalizadores XAUDIO2_VOICE_NOPITCH ou XAUDIO2_VOICE_NOSRC e não deve ter nenhum buffer enfileirado no momento.

O uso típico de SetSourceSampleRate é para dar suporte ao pool de voz. Por exemplo, para dar suporte ao pool de voz, um aplicativo criaria previamente todas as vozes que ele espera usar. Sempre que um novo som for reproduzido, o aplicativo escolherá uma voz inativa ou , se todas as vozes estiverem ocupadas, escolha a voz menos importante e chame SetSourceSampleRate na voz com a taxa de exemplo do novo som. Depois que SetSourceSampleRate tiver sido chamado na voz, o aplicativo poderá iniciar imediatamente o envio e a reprodução de buffers com a nova taxa de exemplo. Isso permite que o aplicativo evite a sobrecarga de criar e destruir vozes com frequência durante o jogo.

Requisitos da plataforma

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); SDK do DirectX (XAudio 2.7)

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	xaudio2.h

Confira também

IXAudio2SourceVoice