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 を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。
リターン コード | 説明 |
---|---|
|
ISpatialAudioMetadataItems が Open の呼び出しでコピー用に開かれていません。または、オブジェクトが Close の呼び出しで書き込みのために閉じられました。 |
|
指定されたポインターの 1 つが無効です。 |
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | spatialaudiometadata.h |