次の方法で共有

KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR

  • [アーティクル]

KSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR プロパティは、3D リスナーのロールオフ係数を指定します。

用法の要点テーブル

Yammer の入手 設定 移行先 プロパティ記述子の種類 プロパティ値の種類

はい

はい

ピン留めする

KSNODEPROPERTY

FLOAT

プロパティ値 (操作データ) は FLOAT 型で、ロールオフ係数を指定します。 ロールオフ係数は、それぞれ 0.0 と 10.0 として定義される DS3D_MINROLLOFFFACTOR から DS3D_MAXROLLOFFFACTOR までの範囲で指定できます。 既定のロールオフ係数は DS3D_DEFAULTROLLOFFFACTOR で、1.0 と定義されています。

戻り値

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

解説

ロールオフは、音源からのリスナーの距離に基づいて、サウンドに適用される減衰の量です。 ロールオフ係数が 0 の場合、リスナーからの距離に関係なく、サウンドは減衰されません。 1 より大きい係数は、実際の音の減衰を距離と共に誇張します。

DirectSound では、このプロパティを使用して、IDirectSound3DListener::GetPosition および IDirectSound3DListener::SetRolloffFactor メソッドを実装します。これは、Microsoft Windows SDK ドキュメントで説明されています。

要件

ヘッダー

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

関連項目

KSNODEPROPERTY