MFPKEY_WMADEC_FOLDDOWN_MATRIX プロパティ

エンコードされたストリームに含まれるチャネルよりも少ないチャネルに対してマルチチャネル オーディオをデコードするための、作成者が提供する折りたたみ係数を指定します。

IPropertyBag の定数

g_wszWMACFoldDownXToYChannels

g_wszWMACFoldXToYChannelsZ

データ型

VT_ARRAY |VT_I4

解説

オーディオ デコーダーは、DirectX メディア オブジェクト (DMO) または Media Foundation Transform (MFT) として機能できます。 デコーダーが DMO または MFT として機能する場合の詳細については、「 コーデック オブジェクト」の下の個々のコーデック参照ページを参照してください。

デコーダーを DMO として使用する場合、デコーダーはチャネルフォールドダウンを実行でき、 IMediaObject::GetOutputType を呼び出すことで、折りたたまれた出力メディアの種類を列挙できます。

デコーダーを MFT として使用する場合、デコーダーは既定ではフォールドダウンを実行せず、フォールドダウンされた出力メディアの種類も提供しません。 MFT として機能するデコーダーは、カスタムフォールドダウン係数が MFPKEY_WMADEC_FOLDDOWN_MATRIX プロパティを使用して設定されている場合にのみ、フォールドダウンを実行します。

オーディオ デコーダー MFT で MFPKEY_WMADEC_FOLDDOWN_MATRIX プロパティが設定されておらず、フォールドダウンを実行する場合は、(MFT として) Audio Resampler デジタルシグナル プロセッサを使用できます。

このプロパティの値は、整数値のコンマ区切りのリストに折りたたみ係数を含む文字列です。 リストには、エンコードされたコンテンツ内のチャネルごとに、デコードされたコンテンツ内のチャネルの数と同じ数の整数が含まれている必要があります。

係数が 0 の場合、文字列で使用される値は "-2147483648" である必要があります。それ以外の場合、値は 20 * 65536 * log10(x) という数式を使用して計算されます。

係数は、mmreg.h ヘッダー ファイルに含まれるチャネル マスク定数で定義されているように、チャネル マスク順に一覧表示されます。 したがって、6 チャネルから 2 チャネルのフォールドダウンの最初の 2 つの値は、6 チャネル ストリーム内の中央左チャネルで構成される左出力チャネルと右出力チャネルの部分を表します。

このプロパティは、作成者が指定したフォールドダウン値がエンコードされたコンテンツと共に永続化される場合にのみ設定する必要があります。 それ以外の場合は、デコーダーが独自の計算を行います。

現在、Windows Media Audio 10 Professional コーデックでは、2 つのチャネルへのフォールドダウンのみがサポートされています。

MFPKEY_WMADEC_SPKRCFG プロパティが DSSPEAKER_SURROUND に設定されている場合、コーデックは作成者が指定したフォールドダウン係数を無視し、受信側のマトリックス デコーダーによって処理できる 2 チャネル信号にフォールドダウンされます。 これにより、サラウンド機器は4つのチャネルを提供できます。 このモードは、ソースが 5.1 の場合にのみサポートされます。 コーデックは、8 チャネルから 2 つのチャネルにのみフォールドできます。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	Wmcodecdsp.h

関連項目

Media Foundation のプロパティ