Platform SDK: DirectX

IDirectSound::GetSpeakerConfig

IDirectSound::GetSpeakerConfig メソッドは、DirectSound オブジェクトに割り当てられたスピーカの構成を取得する。

HRESULT GetSpeakerConfig(
  LPDWORD lpdwSpeakerConfig  
);

パラメータ

lpdwSpeakerConfig
この DirectSound オブジェクト用のスピーカの構成へのポインタ。スピーカの構成は以下の値のいずれかで指定される。
DSSPEAKER_5POINT1
オーディオはサブウーファ付きのサラウンド スピーカのスピーカ配置から出力される。
DSSPEAKER_HEADPHONE
オーディオはヘッドホンから出力される。
DSSPEAKER_MONO
オーディオはモノラル スピーカから出力される。
DSSPEAKER_QUAD
オーディオは 4 チャンネル ステレオ スピーカから出力される。
DSSPEAKER_STEREO
オーディオはステレオ スピーカから出力される (デフォルト値)。
DSSPEAKER_SURROUND
オーディオはサラウンド スピーカから出力される。
DSSPEAKER_STEREO は以下の値のいずれかとの組み合わせになる。
DSSPEAKER_GEOMETRY_WIDE
2 つのスピーカはリスナーを中心として 20 度の角度に置かれている。
DSSPEAKER_GEOMETRY_NARROW
2 つのスピーカはリスナーを中心として 10 度の角度に置かれている。
DSSPEAKER_GEOMETRY_MIN
2 つのスピーカはリスナーを中心として 5 度の角度に置かれている。
DSSPEAKER_GEOMETRY_MAX
2 つのスピーカはリスナーを中心として 180 度の角度に置かれている。

戻り値

成功すれば DS_OK、失敗すれば次のエラー値のいずれかを返す。

DSERR_INVALIDPARAM
DSERR_UNINITIALIZED

注意

lpdwSpeakerConfig に返される値は、構成とジオメトリ情報の両方を保持するパック DWORD となることがある。DWORD をアンパックするには、次の例のように DSSPEAKER_CONFIG DSSPEAKER_GEOMETRY の各マクロを使う。

if (DSSPEAKER_CONFIG(dwSpeakerConfig) == DSSPEAKER_STEREO)
    {
    if (DSSPEAKER_GEOMETRY(dwSpeakerConfig) ==
                      DSSPEAKER_GEOMETRY_WIDE)
       {...}
    }

動作環境

  Windows NT/2000 : Service Pack 3 を適用した Windows NT バージョン 4.0 以降が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsound.h で宣言。
  インポート ライブラリ : dsound.lib を使用。

参照

IDirectSound::SetSpeakerConfigスピーカの構成