Поделиться через

Метод ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects (spatialaudioclient.h)

  • Статья

Переводит систему в состояние, в котором данные аудиообъекта могут быть отправлены для обработки и состояние ISpatialAudioObject можно изменить.

Синтаксис

HRESULT BeginUpdatingAudioObjects(
  [out] UINT32 *availableDynamicObjectCount,
  [out] UINT32 *frameCountPerBuffer
);

Параметры

[out] availableDynamicObjectCount

Количество динамических звуковых объектов, доступных для отрисовки для текущего прохода обработки. Все выделенные статические звуковые объекты могут отображаться за каждый проход. Сведения о типах звуковых объектов см. в разделе AudioObjectType.

[out] frameCountPerBuffer

Размер (в аудиокадрах) буфера, возвращаемого GetBuffer.

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

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата Описание
SPTLAUDCLNT_E_OUT_OF_ORDER
 Метод BeginUpdatingAudioObjects был вызван дважды без соответствующего вызова EndUpdatingAudioObjects между двумя вызовами.
SPTLAUDCLNT_E_DESTROYED
 ISpatialAudioClient, связанный с пространственным аудиопотоком, был уничтожен.
AUDCLNT_E_DEVICE_INVALIDATED
 Устройство конечной точки звука было отключено, или звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом стали недоступными для использования.
AUDCLNT_E_RESOURCES_INVALIDATED
 Ресурс, связанный с пространственным аудиопотоком, больше недействителен.
SPTLAUDCLNT_E_INTERNAL
 Произошла внутренняя ошибка.
AUDCLNT_E_UNSUPPORTED_FORMAT
 Носитель, связанный с пространственным аудиопотоком, использует неподдерживаемый формат.

Комментарии

Этот метод необходимо вызывать при каждом сигнале события, переданного в SpatialAudioObjectRenderStreamActivationParamsв ISpatialAudioClient::ActivateSpatialAudioStream .
даже если нет звуковых данных объекта для отправки.

Для каждого вызова BeginUpdatingAudioObjects должен быть соответствующий вызов EndUpdatingAudioObjects .
Если BeginUpdatingAudioObjects вызывается дважды без вызова EndUpdatingAudioObjects между ними, второй вызов
BeginUpdatingAudioObjects вернет SPTLAUDCLNT_E_OUT_OF_ORDER.

Требования

   
Целевая платформа Windows
Header spatialaudioclient.h

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

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase