PKEY_AudioEndpoint_Disable_SysFx

  • [アーティクル]

PKEY_AudioEndpoint_Disable_SysFx プロパティは、オーディオ エンドポイント デバイスとの間を流れる共有モード ストリームでシステム効果を有効にするかどうかを指定します。

システム効果は、オーディオ ストリームに挿入できるオーディオ処理オブジェクト (API) として実装されます。 API は、ボリューム制御やフォーマット変換などのオーディオ処理機能を実行するソフトウェア モジュールです。 エンドポイント デバイスのシステム効果を無効にすると、関連付けられているストリームが変更されていない API を通過できるようになります。

API として実装されるシステム効果の詳細については、「 Windows オーディオ処理オブジェクト」を参照してください。

このプロパティは、エンドポイント デバイスが接続されているオーディオ アダプターをインストールした .inf ファイルによってインストールされたローカル効果とグローバル効果の API にのみ適用されます。 さらに、このプロパティはターゲット エンドポイント デバイスにのみ影響します。同じアダプターに接続しても、他のエンドポイント デバイスのシステム効果には影響しません。

PROPVARIANT 構造体の vt メンバーは、VT_UI4に設定されます。

PROPVARIANT 構造体の ulVal メンバーは、システム効果が有効になっている場合はENDPOINT_SYSFX_ENABLEDに設定され、無効になっている場合はENDPOINT_SYSFX_DISABLEDに設定されます。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
Header
Mmdeviceapi.h

関連項目

オーディオ エンドポイントのプロパティ

コア オーディオのプロパティ