KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR

  • [アーティクル]

KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR プロパティは、任意の距離値に適用する必要がある距離係数を指定します。

用法の要点テーブル

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

はい

はい

ピン留めする

KSNODEPROPERTY

FLOAT

プロパティ値 (操作データ) は FLOAT 型で、距離係数を指定します。

戻り値

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

解説

KSPROPSETID_DirectSound3DBuffer および KSPROPSETID_DirectSound3DListener プロパティの距離は、メートル × 距離係数の単位で示されます。

既定では、距離係数は 1 で、距離はメートル単位で表されます。 (また、既定の速度単位はメートル/秒です)。

クライアントは、異なる距離係数を指定する KSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR set-property 要求を使用すると、KSPROPSETID_DirectSound3DBuffer および KSPROPSETID_DirectSound3DListener プロパティの距離単位を変更できます。

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

要件

ヘッダー

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

関連項目

KSNODEPROPERTY