SpatialAudioObjectRenderStreamForMetadataActivationParams 構造体 (spatialaudiometadata.h)

  • [アーティクル]

メタデータの空間オーディオ レンダリング ストリームのアクティブ化パラメーターを表します。 ストリームをアクティブ化するときに 、この構造体を ISpatialAudioClient::ActivateSpatialAudioStream に渡します。

構文

typedef struct SpatialAudioObjectRenderStreamForMetadataActivationParams {
  const WAVEFORMATEX                    *ObjectFormat;
  AudioObjectType                       StaticObjectTypeMask;
  UINT32                                MinDynamicObjectCount;
  UINT32                                MaxDynamicObjectCount;
  AUDIO_STREAM_CATEGORY                 Category;
  HANDLE                                EventHandle;
  GUID                                  MetadataFormatId;
  UINT16                                MaxMetadataItemCount;
  const PROPVARIANT                     *MetadataActivationParams;
  ISpatialAudioObjectRenderStreamNotify *NotifyObject;
} SpatialAudioObjectRenderStreamForMetadataActivationParams;

メンバー

ObjectFormat

1 つの空間オーディオ オブジェクトの書式記述子。 ストリームで使用されるすべてのオブジェクトの形式は同じで、形式は WAVEFORMATEX または WAVEFORMATEXTENSIBLE である必要があります。

StaticObjectTypeMask

アクティブ化されたストリームで許可される静的空間オーディオ チャネルのセットを示す AudioObjectType 値のビットごとの組み合わせ。

MinDynamicObjectCount

同時実行動的オブジェクトの最小数。 この数の動的オーディオ オブジェクトを同時にアクティブ化できない場合、 ISpatialAudioClient::ActivateSpatialAudioStream は、このエラー SPTLAUDCLNT_E_NO_MORE_OBJECTSで失敗します。

MaxDynamicObjectCount

ISpatialAudioObjectRenderStream でアクティブ化できる同時動的オブジェクトの最大数。

Category

オーディオ ストリームとその空間オーディオ オブジェクトのカテゴリ。

EventHandle

より多くのオーディオ データを提供するようにクライアントに通知するイベント。 このハンドルは、使用される前に内部的に複製されます。

MetadataFormatId

現在アクティブな空間レンダリング エンジンのメタデータ形式の識別子。

MaxMetadataItemCount

フレームあたりのメタデータ項目の最大数。

MetadataActivationParams

追加のアクティブ化パラメーター。

NotifyObject

空間オーディオ クライアントが ISpatialAudioObjectRenderStream の状態の変化に応答するための通知を提供する オブジェクト。 このオブジェクトは、同時にアクティブ化できる動的空間オーディオ オブジェクトの数が変更されようとしていることをクライアントに通知するために使用されます。

要件

要件 値
Header spatialaudiometadata.h