次の方法で共有

IDirectSound8::GetSpeakerConfig

  • [アーティクル]

スピーカの構成を取得する。

構文

  HRESULT GetSpeakerConfig(
  LPDWORD
   pdwSpeakerConfig 

  );

パラメータ

pdwSpeakerConfig

このデバイスに対するスピーカの構成へのポインタ。スピーカの構成は、次の表で示す値のいずれかで指定される。

 

値 説明
DSSPEAKER_5POINT1 オーディオは、サブウーファ付きの 5 サラウンド スピーカのスピーカ配置から出力される。
DSSPEAKER_DIRECTOUT オーディオは、スピーカ用の構成は行われずに直接渡される。
DSSPEAKER_HEADPHONE オーディオは、ヘッドホンから出力される。
DSSPEAKER_MONO オーディオは、モノラル スピーカから出力される。
DSSPEAKER_QUAD オーディオは、4 チャンネル ステレオ スピーカから出力される。
DSSPEAKER_STEREO オーディオは、ステレオ スピーカから出力される (デフォルト値)。
DSSPEAKER_SURROUND オーディオは、サラウンド スピーカから出力される。
DSSPEAKER_7POINT1 オーディオは、サブウーファ付きの 7 サラウンド スピーカのスピーカ配置から出力される。

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

注意

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

if (DSSPEAKER_CONFIG(dwSpeakerConfig) == DSSPEAKER_STEREO)
  {
  if (DSSPEAKER_GEOMETRY(dwSpeakerConfig) ==
        DSSPEAKER_GEOMETRY_WIDE)
    {
      // 構成はワイド ステレオである。
 ...}
  }

要件

**  ヘッダー:**dsound.h で宣言。

参照