IDirectSound3DBuffer8::SetMode

SetMode メソッドは、3D サウンド処理の操作モードを設定します。

HRESULT 
SetMode(
  DWORD dwMode,
  DWORD dwApply
);

パラメータ

• dwMode
  設定する 3D サウンド処理モードを指定するフラグです。次の表に示すフラグが定義されています。

  値	説明
  DS3DMODE_DISABLE	3D サウンドの処理は無効です。サウンドは、リスナーの頭の中心で発生しているように聞こえます。
  DS3DMODE_HEADRELATIVE	サウンド パラメーター (位置、速度および向き) は、リスナーのパラメーターに対して相対的です。このモードでは、サウンドの絶対パラメーターはリスナーのパラメーターの変化に応じて自動的に更新され、相対パラメーターは一定に保たれます。
  DS3DMODE_NORMAL	標準の処理です。これは、デフォルトのモードです。

• dwApply
  設定を適用するタイミングを指定する値です。次の表に示す値のいずれかでなければなりません。

  値	説明
  DS3D_DEFERRED	アプリケーションが CommitDeferredSettings メソッドを呼び出すまで、設定は適用されません。これにより、複数の設定を変更した後に、1 回の再計算でそれらを適用できます。
  DS3D_IMMEDIATE	設定が直ちに適用され、すべての 3D サウンド バッファーの 3D 座標が再計算されます。

戻り値

成功した場合は、DS_OK を返します。失敗した場合は、DSERR_INVALIDPARAM を返します。

要件

ヘッダー: DSound.h 宣言

ライブラリ: Dsound3d.dll 内容

関連項目

IDirectSound3DBuffer8