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

Метод ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf (spatialaudiohrtf.h)

  • Статья

Активирует ISpatialAudioObjectForHrtf для отрисовки звука.

Синтаксис

HRESULT ActivateSpatialAudioObjectForHrtf(
  [in]  AudioObjectType            type,
  [out] ISpatialAudioObjectForHrtf **audioObject
);

Параметры

[in] type

Тип активируемого звукового объекта. Для динамических звуковых объектов это значение должно быть AudioObjectType_Dynamic. Для статических звуковых объектов укажите одно из значений статического звукового канала из перечисления . При указании AudioObjectType_None создается не пространственный объект.

[out] audioObject

Получает указатель на активированный интерфейс.

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

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

Код возврата Описание
SPTLAUDCLNT_E_NO_MORE_OBJECTS
В системе достигнуто максимальное количество одновременных звуковых объектов.
SPTLAUDCLNT_E_DESTROYED
 ISpatialAudioClient, связанный с пространственным аудиопотоком, был уничтожен.
AUDCLNT_E_DEVICE_INVALIDATED
 Устройство конечной точки звука было отключено, или звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом стали недоступными для использования.
SPTLAUDCLNT_E_INTERNAL
 Произошла внутренняя ошибка.
AUDCLNT_E_UNSUPPORTED_FORMAT
 Носитель, связанный с пространственным аудиопотоком, использует неподдерживаемый формат.

Комментарии

Динамический ISpatialAudioObjectForHrtf был активирован путем установки для параметра type метода ActivateSpatialAudioObjectForHrtfAudioObjectType_Dynamic. Клиент имеет ограничение на максимальное количество динамических пространственных звуковых объектов, которые могут быть активированы одновременно. После достижения ограничения попытка активировать дополнительные звуковые объекты приведет к тому, что этот метод вернет ошибку SPTLAUDCLNT_E_NO_MORE_OBJECTS. Чтобы избежать этого, вызовите Release для каждого динамического ISpatialAudioObjectForHrtf после того, как он больше не используется для освобождения ресурса, чтобы его можно было перераспределить. Дополнительные сведения об управлении временем существования пространственных звуковых объектов см. в разделах ISpatialAudioObjectgBase::SetEndOfStream: IsActive и ISpatialAudioObjectgBase::SetEndOfStream.

Требования

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

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

ISpatialAudioRenderStreamForHrtf