共用方式為

ISpatialAudioMetadataWriter：：WriteNextItemCommand 方法 (spatialaudiometadata.h)

  • 發行項

將中繼資料命令和值資料寫入目前專案。

語法

HRESULT WriteNextItemCommand(
  [in] BYTE       commandID,
  [in] const void *valueBuffer,
  [in] UINT32     valueBufferLength
);

參數

[in] commandID

物件的元資料格式所支援的命令。 如果命令未由元資料格式定義，則呼叫將會失敗。 每個命令只能為每個專案寫入一次。

[in] valueBuffer

緩衝區的指標，儲存元資料格式定義所指定之命令特有的資料。

[in] valueBufferLength

valueBuffer參數中提供之命令資料的大小，以位元組為單位。 大小必須符合元資料格式所指定的命令定義，否則呼叫將會失敗。

傳回值

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

傳回碼 Description
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems尚未開啟以呼叫Open撰寫，或物件已關閉以呼叫Close寫入。
SPTLAUD_MD_CLNT_E_NO_ITEMOFFSET_WRITTEN

在呼叫 Open之後，以及呼叫 WriteNextItemCommand 之前，未呼叫 WriteNextItem。

備註

您必須呼叫Open開啟ISpatialAudioMetadataWriter以進行寫入，並呼叫WriteNextItemCommand 之前呼叫 WriteNextItem來設定目前的中繼資料專案位移。

規格需求

   
目標平台 Windows
標頭 spatialaudiometadata.h

另請參閱

ISpatialAudioMetadataWriter