Метод ISpatialAudioMetadataClient::ActivateSpatialAudioMetadataItems (spatialaudiometadata.h)

Статья
08/26/2023

Создает объект ISpatialAudioMetadataItems для хранения элементов пространственных звуковых метаданных.

Синтаксис

HRESULT ActivateSpatialAudioMetadataItems(
  [in]            UINT16                           maxItemCount,
  [in]            UINT16                           frameCount,
  [out, optional] ISpatialAudioMetadataItemsBuffer **metadataItemsBuffer,
  [out]           ISpatialAudioMetadataItems       **metadataItems
);

Параметры

[in] maxItemCount

Максимальное количество элементов метаданных, которые могут храниться в возвращенных элементах ISpatialAudioMetadataItems.

[in] frameCount

Допустимый диапазон позиций смещения кадра для элементов метаданных, хранящихся в возвращенных элементах ISpatialAudioMetadataItems.

[out, optional] metadataItemsBuffer

Если указан указатель, возвращает интерфейс ISpatialAudioMetadataItemsBuffer , который предоставляет методы для присоединения памяти, предоставляемой вызывающим, для хранения элементов метаданных. Если этот параметр имеет значение NULL, объект выделяет внутреннее хранилище для элементов. Этот интерфейс не может быть получен с помощью QueryInterface.

[out] metadataItems

Получает экземпляр объекта ISpatialAudioMetadataItems , который может быть заполнен элементами метаданных с помощью ISpatialAudioMetadataWriter или ISpatialAudioMetadataCopier и может быть считан с помощью ISpatialAudioMetadataReader.

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

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

Код возврата	Описание
E_INVALIDARG	Недопустимый указатель, указанный в параметре metadataItems . Значение maxItemCount или frameCount равно 0.

Требования


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

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

ISpatialAudioMetadataClient

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