KSPROPERTY_SYSAUDIO_SELECT_GRAPH

KSPROPERTY_SYSAUDIO_SELECT_GRAPH プロパティは、仮想オーディオ デバイスのピン インスタンス用に SysAudio がビルドされているグラフのオプションのノードを明示的に含めるために使用されます。

用法の要点テーブル

プロパティ記述子 (インスタンス データ) は、プロパティ、ピン ID、およびノード ID を指定する SYSAUDIO_SELECT_GRAPH 型の構造体です。 プロパティは、KSPROPERTY 型の埋め込み構造体が指定します。 ピン ID は、仮想オーディオ デバイスをラップする KS フィルター内のピン ファクトリを識別するインデックスです。 ノード ID は、指定したピンのデータ パス内の省略可能なノードを識別するインデックスです。 詳細については、「解説」を参照してください。

このプロパティに対してプロパティ値 (操作データ) は定義されていません。 プロパティ値のバッファー ポインターを NULL、そのサイズを 0 として指定します。

戻り値

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

解説

通常、このプロパティは、ピン インスタンスのグラフに AEC ノードを強制的に挿入するために使用されます。

仮想オーディオ デバイスのフィルターでレンダリング ピンをインスタンス化する場合、SysAudio はピンから開始し、既定ではフィルターを通過する最も簡単なパスを表すグラフを選択します。 このグラフでは、AEC コントロールなどの任意のノードが除外されます。

SysAudio の既定の動作をオーバーライドするには、まず、グラフに含める省略可能なノードを指定する KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property 要求を SysAudio に送信します。 その後 SysAudio がピン インスタンスを作成すると、ピンのグラフには、要求で指定されたオプションのノードが含まれます。

KSPROPERTY_SYSAUDIO_SELECT_GRAPH set-property 要求は、要求後に作成されたピン インスタンスのみに影響します。 要求は、以前にインスタンス化されたピンには影響しません。

要件

関連項目

SYSAUDIO_SELECT_GRAPH

KSPROPERTY