Метод IXAudio2SourceVoice::SetSourceSampleRate (xaudio2.h)

  • Статья

Перенастраивает голос для использования исходных данных с частотой выборки, отличной от частоты, указанной при создании голоса.

Синтаксис

HRESULT SetSourceSampleRate(
  [in] UINT32 NewSourceSampleRate
);

Параметры

[in] NewSourceSampleRate

Новая частота выборки, на который голос должен обработать отправленные данные. Допустимые частоты выборки : от 1 до 200 кГц.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения, в противном случае — код ошибки. Описание кодов ошибок см. в разделе Коды ошибок XAudio2 .

Комментарии

Метод SetSourceSampleRate поддерживает повторное использование голосов XAudio2, позволяя голосу воспроизводить звуки с различными частотами выборки. Чтобы использовать SetSourceSampleRate , голос должен быть создан без флагов XAUDIO2_VOICE_NOPITCH или XAUDIO2_VOICE_NOSRC и не должен содержать буферы в очереди.

Обычно SetSourceSampleRate используется для поддержки голосовых пулов. Например, для поддержки голосового пула приложение предварительно создаст все голоса, которые оно ожидает использовать. При воспроизведении нового звука приложение выбирает неактивный голос или , если все голоса заняты, выбирает наименее важный голос и вызывает SetSourceSampleRate для голоса с частотой выборки нового звука. После вызова метода SetSourceSampleRate в голосовой связи приложение может сразу же начать отправку и воспроизведение буферов с новой частотой выборки. Это позволяет приложению избежать накладных расходов, связанных с созданием и уничтожением голосов во время игры.

Требования к платформе

Windows 10 (XAudio2.9); Windows 8, Windows Phone 8 (XAudio 2.8); Пакет SDK Для DirectX (XAudio 2.7)

Требования

Требование Значение
Целевая платформа Windows
Header xaudio2.h

См. также раздел

IXAudio2SourceVoice