IDirectSound3DBuffer8::SetMode
3D サウンド処理の操作モードを設定する。
構文
HRESULT SetMode(
DWORD
dwMode
,
DWORD
dwApply
);
パラメータ
dwMode
設定する 3D サウンド処理モードを指定するフラグ。次のフラグが定義されている。
値 | 説明 |
DS3DMODE_DISABLE | 3D サウンドの処理は無効である。サウンドは、リスナーの頭の中心で発生しているように聞こえる。 |
DS3DMODE_HEADRELATIVE | サウンド パラメータ (位置・速度・向き) は、リスナーのパラメータに対して相対的なものである。このモードでは、リスナーのパラメータが変化するとサウンドの絶対パラメータは自動的に更新されるので、相対パラメータは一定に保たれる。 |
DS3DMODE_NORMAL | 標準の処理。これはデフォルトのモードである。 |
dwApply
設定を適用するタイミングを指定する値。次の値のいずれかでなければならない。
値 | 説明 |
DS3D_DEFERRED | アプリケーションが IDirectSound3DListener8::CommitDeferredSettings メソッドを呼び出すまで、設定は適用されない。複数の設定を変更した後、1 回の再計算でそれらを適用できる。 |
DS3D_IMMEDIATE | 設定を直ちに適用し、システムはすべての 3D サウンド バッファの 3D 座標を再計算する。 |
戻り値
成功した場合は DS_OK を返す。
失敗した場合は DSERR_INVALIDPARAM を返す。
要件
** ヘッダー:**dsound.h で宣言。
参照