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

Структура SpatialAudioObjectRenderStreamForMetadataActivationParams (spatialaudiometadata.h)

  • Статья

Представляет параметры активации для потока отрисовки пространственного звука для метаданных. Передайте эту структуру в ISpatialAudioClient::ActivateSpatialAudioStream при активации потока.

Синтаксис

typedef struct SpatialAudioObjectRenderStreamForMetadataActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  GUID                                  MetadataFormatId;
  UINT16                                MaxMetadataItemCount;
  const PROPVARIANT                     *MetadataActivationParams;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamForMetadataActivationParams;

Члены

ObjectFormat

Дескриптор форматирования для одного пространственного звукового объекта. Все объекты, используемые потоком, должны иметь одинаковый формат и иметь тип WAVEFORMATEX или WAVEFORMATEXTENSIBLE.

StaticObjectTypeMask

Побитовое сочетание значений AudioObjectType , указывающее набор статических пространственных звуковых каналов, разрешенных активированным потоком.

MinDynamicObjectCount

Минимальное количество параллельных динамических объектов. Если это количество динамических звуковых объектов не удается активировать одновременно, ISpatialAudioClient::ActivateSpatialAudioStream завершится сбоем с этой ошибкой SPTLAUDCLNT_E_NO_MORE_OBJECTS.

MaxDynamicObjectCount

Максимальное количество параллельных динамических объектов, которые можно активировать с помощью ISpatialAudioObjectRenderStream.

Category

Категория звукового потока и его пространственных звуковых объектов.

EventHandle

Событие, которое сигнализирует клиенту о предоставлении дополнительных звуковых данных. Этот дескриптор будет продублирован внутри системы перед его использованием.

MetadataFormatId

Идентификатор формата метаданных для активного в данный момент модуля пространственной отрисовки.

MaxMetadataItemCount

Максимальное количество элементов метаданных на кадр.

MetadataActivationParams

Дополнительные параметры активации.

NotifyObject

Объект , предоставляющий уведомления для клиентов пространственного звука для реагирования на изменения в состоянии ISpatialAudioObjectRenderStream. Этот объект используется для уведомления клиентов о том, что количество динамических пространственных звуковых объектов, которые могут быть активированы одновременно, вскоре изменится.

Требования

Требование Значение
Заголовок spatialaudiometadata.h