Метод 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 |