共用方式為

ISpatialAudioMetadataWriter：：WriteNextItem 方法 (spatialaudiometadata.h)

  • 發行項

在指定的位移處啟動新的中繼資料專案。

語法

HRESULT WriteNextItem(
  [in] UINT16 frameOffset
);

參數

[in] frameOffset

以ActivateSpatialAudioMetadataItems之frameCount參數指定的範圍內專案的框架位移。

傳回值

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

傳回碼 描述
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems尚未開啟以呼叫Open寫入，或物件已關閉，以呼叫Close寫入。
SPTLAUD_MD_CLNT_E_FRAMEOFFSET_OUT_OF_RANGE
 寫入會話中寫入的專案數目大於在 SpatialAudioObjectRenderStreamForMetadataActivationParam中傳遞至ISpatialAudioClient：：ActivateSpatialAudioAudioStream的MaxMetadataItemCount欄位中提供的值。

frameCount值大於ActivateSpatialAudioMetadataItems的frameCount參數值，並將溢位模式設定為SpatialAudioMetadataWriterOverflow_Fail。
E_INVALIDARG
 frameOffset的值不大於在相同寫入會話內對WriteNextItem上一次呼叫中提供的值。

備註

在呼叫 WriteNextItem之前，您必須開啟 ISpatialAudioMetadataWriter ，以在建立物件之後呼叫 Open ，並在呼叫 Close 之後呼叫 來 寫入。 在呼叫 Open 和 Close的寫入會話期間， frameOffset 參數的值必須大於上述呼叫中的值。

在單一寫入會話內，您不得使用WriteNextItem來寫入超過SpatialAudioObjectRenderStreamForMetadataActivationParam中傳遞至ISpatialAudioClient：：ActivateSpatialAudioStream或發生SPTLAUD_MD_CLNT_E_FRAMEOFFSET_OUT_OF_RANGE錯誤的值。

如果溢位模式設定為 SpatialAudioMetadataWriterOverflow_Fail， 則 frameOffset 參數的值必須小於 frameCount 參數的值，才會發生 ActivateSpatialAudioMetadataItems 或發生SPTLAUD_MD_CLNT_E_FRAMEOFFSET_OUT_OF_RANGE錯誤。

呼叫 WriteNextItem之後，呼叫 WriteNextItemCommand 以撰寫專案的中繼資料命令和值資料。

規格需求

   
目標平台 Windows
標頭 spatialaudiometadata.h

另請參閱

ISpatialAudioMetadataWriter