ISpatialAudioMetadataCopier：：CopyMetadataForFrames 方法 (spatialaudiometadata.h)

  • 發行項

從來源 ISpatialAudioMetadataItems 複製元數據專案，提供給 Open 方法的物件，物件到目的地 ISpatialAudioMetadataItems 物件，並使用 dstMetadataItems 參數指定。 每個呼叫都會依 copyFrameCount 參數中的框架數目來前進內部複製位置。

語法

HRESULT CopyMetadataForFrames(
  [in]  UINT16                       copyFrameCount,
  [in]  SpatialAudioMetadataCopyMode copyMode,
  [in]  ISpatialAudioMetadataItems   *dstMetadataItems,
  [out] UINT16                       *itemsCopied
);

參數

[in] copyFrameCount

從目前複製位置複製元數據專案的框架數目。 複製之後，來源 SpatialAudioMetadataItems 中的內部複製位置會進階此參數中指定的值。 將此值設定為 0，以複製來源 SpatialAudioMetadataItems 中包含的整個框架範圍。

[in] copyMode

值，指定作業的複製模式。

[in] dstMetadataItems

複製作業目的地 SpatialAudioMetadataItems 的指標。

[out] itemsCopied

接收作業中複製的元數據項目數目。

傳回值

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

傳回碼 Description
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN
 ISpatialAudioMetadataItems 尚未開啟，無法透過對 Open 的呼叫進行複製，或物件已關閉，以呼叫 Close 進行寫入。
E_INVALIDARG
 其中一個提供的指標無效。

規格需求

需求 值
目標平台 Windows
標頭 spatialaudiometadata.h

另請參閱

ISpatialAudioMetadataCopier