WASAPI について

Windows オーディオ セッション API (WASAPI) を使用すると、クライアント アプリケーションは、アプリケーションとオーディオ エンドポイント デバイスの間のオーディオ データのフローを管理できます。

ヘッダー ファイル Audioclient.h および Audiopolicy.h は、WASAPI インターフェイスを定義します。

すべてのオーディオ ストリームは、オーディオ セッションのメンバーです。 セッションの抽象化により、WASAPI クライアントは、関連するオーディオ ストリームのグループのメンバーとして、オーディオ ストリームを識別することができます。 システムは、セッション内のすべてのストリームを 1 つのユニットとして管理できます。

オーディオ エンジンは、アプリケーションがオーディオ エンドポイント デバイスへのアクセスを共有するユーザー モードのオーディオ コンポーネントです。 オーディオ エンジンは、エンドポイント バッファーとエンドポイント デバイスの間でオーディオ データの転送を行います。 レンダリング エンドポイント デバイスを介してオーディオ ストリームを再生するために、アプリケーションは定期的にオーディオ データをレンダリング エンドポイント バッファーに書き込みます。 オーディオ エンジンは、さまざまなアプリケーションからのストリームをミックスします。 キャプチャ エンドポイント デバイスからオーディオ ストリームを録音するために、アプリケーションはキャプチャ エンドポイント バッファーからオーディオ データを定期的に読み取ります。

WASAPI は、複数のインターフェイスで構成されています。 その 1 つ目は、IAudioClient インターフェイスです。 WASAPI インターフェイスにアクセスするために、クライアントはまず、パラメーター iid が REFIID IID_IAudioClient に設定された IMMDevice::Activate メソッドを呼び出すことによって、オーディオ エンドポイント デバイスの IAudioClient インターフェイスへの参照を取得します。 クライアントは IAudioClient::Initialize メソッドを呼び出して、エンドポイント デバイス上のストリームを初期化します。 ストリームを初期化した後、クライアントは IAudioClient::GetService メソッドを呼び出すことによって、他の WASAPI インターフェイスへの参照を取得することができます。

WASAPI のメソッドの多くは、クライアント アプリケーションが使用しているオーディオ エンドポイント デバイスが無効になった場合に、AUDCLNT_E_DEVICE_INVALIDATED エラー コードを返します。 多くの場合、アプリケーションはこのエラーから回復できます。 詳細については、「無効なデバイス エラーからの回復」を参照してください。

WASAPI は次のインターフェイスを実装します。

セッション関連のイベントの通知を必要とする WASAPI クライアントでは、次のインターフェイスを実装する必要があります。

関連トピック

ストリームの管理

プログラミング リファレンス