ISpatialAudioMetadataCopier::CopyMetadataForFrames メソッド (spatialaudiometadata.h)

ソース ISpatialAudioMetadataItems からメタデータ項目をコピーします。これは Open メソッドに指定され、オブジェクトは dstMetadataItems パラメーターで指定された宛先の ISpatialAudioMetadataItems オブジェクトにコピーされます。 各呼び出しでは、 copyFrameCount パラメーター内のフレーム数だけ内部コピー位置が進みます。

構文

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

パラメーター

[in] copyFrameCount

メタデータ 項目がコピーされる現在のコピー位置からのフレーム数。 コピー後、ソース SpatialAudioMetadataItems 内の内部コピー位置は、このパラメーターで指定された値を拡張します。 ソース SpatialAudioMetadataItems に含まれるフレーム範囲全体をコピーするには、この値を 0 に設定します。

[in] copyMode

操作のコピー モードを指定する 値。

[in] dstMetadataItems

コピー操作の宛先 SpatialAudioMetadataItems へのポインター。

[out] itemsCopied

操作でコピーされたメタデータ項目の数を受け取ります。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード	説明
SPTLAUD_MD_CLNT_E_NO_ITEMS_OPEN	ISpatialAudioMetadataItems が Open の呼び出しでコピー用に開かれていません。または、オブジェクトが Close の呼び出しで書き込みのために閉じられました。
E_INVALIDARG	指定されたポインターの 1 つが無効です。

要件

要件	値
対象プラットフォーム	Windows
ヘッダー	spatialaudiometadata.h

こちらもご覧ください

ISpatialAudioMetadataCopier