ISpatialAudioMetadataClient::ActivateSpatialAudioMetadataItems メソッド (spatialaudiometadata.h)

空間オーディオ メタデータ項目を格納するための ISpatialAudioMetadataItems オブジェクトを作成します。

構文

HRESULT ActivateSpatialAudioMetadataItems(
  [in]            UINT16                           maxItemCount,
  [in]            UINT16                           frameCount,
  [out, optional] ISpatialAudioMetadataItemsBuffer **metadataItemsBuffer,
  [out]           ISpatialAudioMetadataItems       **metadataItems
);

パラメーター

[in] maxItemCount

返される ISpatialAudioMetadataItems に格納できるメタデータ 項目の最大数。

[in] frameCount

返された ISpatialAudioMetadataItems に格納されているメタデータ項目のフレーム オフセット位置の有効な範囲。

[out, optional] metadataItemsBuffer

ポインターが指定されている場合は、メタデータ項目を格納するために呼び出し元が指定したメモリをアタッチするためのメソッドを提供する ISpatialAudioMetadataItemsBuffer インターフェイスを返します。 このパラメーターが NULL の場合、オブジェクトは項目の内部ストレージを割り当てます。 このインターフェイスは QueryInterface では取得できません。

[out] metadataItems

ISpatialAudioMetadataWriter または ISpatialAudioMetadataCopier を使用してメタデータ項目を設定できるインスタンス ISpatialAudioMetadataItems オブジェクトを受け取り、ISpatialAudioMetadataReader で読み取ることができます。

戻り値

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

リターン コード	説明
E_INVALIDARG	metadataItems パラメーターに指定されたポインターが無効です。 maxItemCount または frameCount の値は 0 です。

要件

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

関連項目

ISpatialAudioMetadataClient