KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST

KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST プロパティは、特定のオーディオ信号処理パスに対して、特定の KS ピン ファクトリに適用されるオーディオ エフェクトの種類の一覧を値とするフィルター プロパティです。

用法の要点テーブル

用法の要点テーブル

Yammer の入手	設定	移行先	プロパティ記述子の種類	プロパティ値の種類
はい	いいえ	ピン ファクトリ (Filter インスタンス経由)	KSP_PIN	KSP_PINMODE

プロパティ値は、KSP_PINMODE 構造体によって識別されるピンの信号処理パスにある 0 個以上のオーディオ エフェクトの種類の GUID (AUDIO_EFFECT_TYPE_ACOUSTIC_ECHO_CANCELLATION など) の配列です。

注 このプロパティには、The KSPROPERTY_TYPE_TOPOLOGY フラグ ビットを設定しないでください。

戻り値

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

解説

オーディオ ドライバーが Microsoft の汎用プロキシ APO を使用して、KS ピン用のさまざまな信号処理パスに含まれているオーディオ エフェクトを取得する場合は、このプロパティがサポートされている必要があります。 汎用プロキシ APO は、msapofxproxy.dll ファイルに含まれています。 オーディオ ドライバー内で、または対応するデジタル信号プロセッサ (DSP) のハードウェア コンポーネント内で、すべての信号処理を実行する場合、APO 内で処理が行われていなければ、オーディオ ドライバーでこの汎用プロキシ APO を使用できます。 この場合、APO の唯一の機能は、信号処理効果をオーディオ システムに報告することです。

汎用プロキシ APO は、オーディオ ドライバーからKSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST を受け取り、それを使用してオーディオ システムに効果を報告します。 汎用プロキシ APO は、KS ピンの filter インターフェイスが有効になっている間、効果の一覧が変更されないことを前提としています。

プロパティ記述子で、KSPROPERTY_AUDIOEFFECTSDISCOVERY_EFFECTSLIST をサポートしていない KS ピンが指定されている場合、ドライバーは STATUS_NOT_SUPPORTED を返す必要があります。

プロパティ記述子で、ドライバーがサポートしていない AudioProcessingMode 値が指定されている場合、ドライバーは STATUS_INVALID_PARAMETER を返す必要があります。 オーディオ ドライバーは、サポートされているオーディオ信号処理モードを示すことができるように、KSPROPERTY_AUDIOSIGNALPROCESSING_MODES プロパティをサポートする必要があることにご注意ください。

要件

バージョン	Windows 8.1
ヘッダー	Msapofxproxy.h

関連項目

KSP_PINMODE

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES