Метод ISpatialAudioMetadataReader::ReadNextItem (spatialaudiometadata.h)
Возвращает количество команд и смещение образца для считываемого элемента метаданных.
Синтаксис
HRESULT ReadNextItem(
[out] UINT8 *commandCount,
[out] UINT16 *frameOffset
);
Параметры
[out] commandCount
Получает количество пар "команда-значение" в считываемом элементе метаданных.
[out] frameOffset
Возвращает смещение кадра, связанное с считываемым элементом метаданных.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
ISpatialAudioMetadataItems не был открыт для чтения с помощью вызова Open или объект был закрыт для записи с помощью вызова Close. |
|
В диапазоне кадров, указанном в вызове ReadItemCountInFrames, больше нет элементов метаданных. |
|
Один из указанных указателей недопустим. |
Комментарии
Перед вызовом ReadNextItem необходимо открыть ISpatialAudioMetadataReader для чтения, вызвав Метод Open после создания объекта и после вызова Close . Необходимо также вызвать ReadItemCountInFrames перед вызовом ReadNextItem.
ISpatialAudioMetadataReader сохраняет внутренний указатель на текущую позицию в общем диапазоне кадров, содержащихся в ISpatialAudioMetadataItems, с которым связан модуль чтения. Каждый вызов этого метода приводит к тому, что указатель будет расширен на количество кадров, указанное в параметре readFrameCount .
Процесс чтения команд и связанных значений является рекурсивным. После каждого вызова ReadItemCountInFrames вызывайте ReadNextItem , чтобы получить количество команд в следующем элементе. После каждого вызова ReadNextItem вызовите ReadNextItemCommand , чтобы прочитать каждую команду для элемента. Повторяйте эту процедуру, пока не будет прочитан весь диапазон кадров ISpatialAudioMetadataItems .
Требования
| Целевая платформа | Windows |
| Header | spatialaudiometadata.h |