KSPROPERTY_AUDIO_MIX_LEVEL_TABLE

KSPROPERTY_AUDIO_MIX_LEVEL_TABLE プロパティは、スーパーミキサー ノード (KSNODETYPE_SUPERMIX) のミックス レベルを指定します。 すべての入力チャンネルと出力チャンネルに関する情報を提供します。

用法の要点テーブル

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	省略可能	ピン留めする	KSNODEPROPERTY	KSAUDIO_MIXLEVEL 構造体の配列

ノードは、KSPROPERTY_TYPE_GET 要求のサポートを実装するために必要です。 ただし、KSPROPERTY_TYPE_SET 要求のサポートは省略可能です。

プロパティ値 (操作データ) は、M 個の入力チャンネルと N 個の出力チャンネルを持つスーパーミキサー ノード内のすべての M*N 個の入出力パスに対してミックス レベルを指定する、KSAUDIO_MIXLEVEL 構造体の配列です。 配列には M*N 個の要素が含まれます。

  KSAUDIO_MIXLEVEL  MixLevel[M*N];

次のテーブルに、スーパーミキサー ノードの M*N 個の入出力パスに対する配列要素のマッピングを示します。

配列要素	入出力パス
MixLevel[0]	入力チャンネル 0 から出力チャンネル 0 へ
MixLevel[1]	入力チャンネル 0 から出力チャンネル 1 へ
MixLevel[N-1]	入力チャンネル 0 から出力チャンネル N-1 へ
MixLevel[N]	入力チャンネル 1 から出力チャンネル 0 へ
MixLevel[N+1]	入力チャンネル 1 から出力チャンネル 1 へ
MixLevel[2N-1]	入力チャンネル 1 から出力チャンネル N-1 へ
MixLevel[M*N-1]	入力チャンネル M-1 から出力チャンネル N-1 へ

次の図は、MixLevel 配列要素の入出力パスへのマッピングを示しています。 各入出力パスを制御する MixLevel 配列要素のインデックスは、角かっこで囲まれています。

入力チャンネル i を出力チャンネル j に接続するパスがない場合、フィルターで配列要素 MixLevel[i*N+j] の Mute メンバーを TRUE に設定する必要があります。

KSAUDIO_MIXLEVEL 配列のサイズは、KSPROPERTY_AUDIO_MIX_LEVEL_CAPS から取得される KSAUDIO_MIXCAP_TABLE 構造体から計算されます。 構造体の InputChannels メンバーと OutputChannels メンバーに値 m と n が含まれている場合、配列サイズは次のとおりです

m * n * sizeof(KSAUDIO_MIXLEVEL)

戻り値

KSPROPERTY_AUDIO_MIX_LEVEL_TABLE プロパティ要求は、正常に完了したことを示すために STATUS_SUCCESS を返します。 それ以外の場合、要求は適切なエラー状態コードを返します。

解説

フィルターは、フィルターの範囲を超えるミックス レベル値 (KSAUDIO_MIXLEVEL の Level メンバー) を指定する KSPROPERTY_AUDIO_MIX_LEVEL_TABLE set-property 要求に成功しますが、サポートされている範囲に (サイレントに) クランプされます。 ただし、このプロパティを取得する後続の要求では、フィルターは使用された実際の値を出力します。

要件

ヘッダー	ksmedia.h (Ksmedia.h をインクルード)

関連項目

KSNODEPROPERTY

KSAUDIO_MIXCAP_TABLE

KSPROPERTY_AUDIO_MIX_LEVEL_CAPS

KSAUDIO_MIXLEVEL

KSNODETYPE_SUPERMIX