ISpatialAudioMetadataReader：：ReadNextItem 方法 (spatialaudiometadata.h)

  • 發行項

取得所讀取中繼資料專案的命令數目和範例位移。

語法

HRESULT ReadNextItem(
  [out] UINT8  *commandCount,
  [out] UINT16 *frameOffset
);

參數

[out] commandCount

接收所讀取中繼資料專案中的命令/值組數目。

[out] frameOffset

取得與正在讀取之中繼資料專案相關聯的框架位移。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼 描述
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems尚未開啟以呼叫Open讀取，或物件已關閉以呼叫Close寫入。
SPTLAUD_MD_CLNT_E_NO_MORE_ITEMS
 呼叫 ReadItemCountInFrames中指定的框架範圍中沒有其他中繼資料專案。
E_INVALIDARG
 其中一個提供的指標無效。

備註

呼叫 ReadNextItem之前，您必須開啟 ISpatialAudioMetadataReader 以供讀取，方法是在建立物件之後呼叫 Open ，並在呼叫 Close 之後呼叫。 您也必須在呼叫ReadNextItem之前呼叫ReadItemCountInFrames。

ISpatialAudioMetadataReader會將目前位置的內部指標保留在與讀取器相關聯之ISpatialAudioMetadataItems所包含之畫面的總計範圍內。 每次呼叫這個方法時，指標都會由 readFrameCount 參數中指定的框架數目進階。

讀取命令和相關聯值的程式會遞迴。 每次呼叫 ReadItemCountInFrames之後，請呼叫 ReadNextItem 以取得下一個專案中的命令數目。 每次呼叫 ReadNextItem之後，呼叫 ReadNextItemCommand 以讀取專案的每個命令。 重複此程式，直到讀取 ISpatialAudioMetadataItems 的整個框架範圍為止。

規格需求

   
目標平台 Windows
標頭 spatialaudiometadata.h

另請參閱

ISpatialAudioMetadataReader