AUDCLNT_SHAREMODE列挙 (audiosessiontypes.h)

  • [アーティクル]

AUDCLNT_SHAREMODE列挙では、オーディオ ストリームを共有モードで実行するか排他モードで実行するかを示す定数を定義します。

構文

typedef enum _AUDCLNT_SHAREMODE {
  AUDCLNT_SHAREMODE_SHARED,
  AUDCLNT_SHAREMODE_EXCLUSIVE
} AUDCLNT_SHAREMODE;

定数

 
AUDCLNT_SHAREMODE_SHARED
オーディオ ストリームは共有モードで実行されます。 詳細については、「解説」を参照してください。
AUDCLNT_SHAREMODE_EXCLUSIVE
オーディオ ストリームは排他モードで実行されます。 詳細については、「解説」を参照してください。

注釈

IAudioClient::Initialize メソッドと IAudioClient::IsFormatSupported メソッドは、AUDCLNT_SHAREMODE列挙で定義されている定数を使用します。

共有モードでは、クライアントはオーディオ エンドポイント デバイスを、他のユーザー モード プロセスで実行されるクライアントと共有できます。 オーディオ エンジンでは、エンジンのミックス形式に一致するクライアント ストリームの形式が常にサポートされます。 さらに、Windows オーディオ サービスがシステム効果をクライアント ストリームに挿入してクライアント形式をミックス形式に変換できる場合は、オーディオ エンジンで別の形式がサポートされる場合があります。

排他モードでは、Windows オーディオ サービスは、クライアントがオーディオ エンドポイント デバイスへの排他的アクセス権を持つ接続を確立しようとします。 このモードでは、オーディオ エンジンは、接続ポイントの作成に役立つシステム効果をローカル ストリームに挿入しません。 オーディオ デバイスで指定した形式を直接処理できるか、メソッドが失敗します。

共有モードストリームと排他モード ストリームの詳細については、「 ユーザー モード オーディオ コンポーネント」を参照してください。

Xbox May 2021 Update 以降では、Xbox でオーディオ クライアントを排他的モードで開くことができます。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
Header audiosessiontypes.h

こちらもご覧ください

コア オーディオ定数

コア オーディオ列挙

IAudioClient::Initialize

IAudioClient::IsFormatSupported