IAudioCaptureClient インターフェイス (audioclient.h)

  • [アーティクル]

IAudioCaptureClient インターフェイスを使用すると、クライアントはキャプチャ エンドポイント バッファーから入力データを読み取ることができます。 クライアントは、パラメーター riid が REFIID IID_IAudioCaptureClientに設定された IAudioClient::GetService メソッドを呼び出して、ストリーム オブジェクトの IAudioCaptureClient インターフェイスへの参照を取得します。

このインターフェイスのメソッドは、キャプチャ データを含むデータ パケットの移動を管理します。 データ パケットの長さは、パケット内のオーディオ フレームの数として表されます。 オーディオ フレームのサイズは、クライアントが IAudioClient::GetMixFormat メソッドを呼び出して取得する WAVEFORMATEX (または WAVEFORMATEXTENSIBLE) 構造体の nBlockAlign メンバーによって指定されます。 オーディオ フレームのサイズ (バイト単位) は、ストリーム内のチャネルの数にチャネルあたりのサンプル サイズを掛けた値と等しくなります。 たとえば、16 ビット サンプルを含むステレオ (2 チャネル) ストリームの場合、フレーム サイズは 4 バイトです。 パケットには常に、オーディオ フレームの整数が含まれます。

IAudioCaptureClient インターフェイス インスタンスを解放する場合、クライアントは、オブジェクトを作成した IAudioClient::GetService の呼び出しと同じスレッドから、インスタンスの Release メソッドを呼び出す必要があります。

IAudioCaptureClient インターフェイスを使用するコード例については、「Streamのキャプチャ」を参照してください。

継承

IAudioCaptureClient インターフェイスは、IUnknown インターフェイスから継承されます。 IAudioCaptureClient には、次の種類のメンバーもあります。

メソッド

IAudioCaptureClient インターフェイスには、これらのメソッドがあります。

 
IAudioCaptureClient::GetBuffer

キャプチャ エンドポイント バッファー内の次に使用可能なデータ パケットへのポインターを取得します。
IAudioCaptureClient::GetNextPacketSize

GetNextPacketSize メソッドは、キャプチャ エンドポイント バッファー内の次のデータ パケット内のフレーム数を取得します。
IAudioCaptureClient::ReleaseBuffer

ReleaseBuffer メソッドはバッファーを解放します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー audioclient.h

こちらもご覧ください

コア オーディオ インターフェイス

IAudioClient::GetMixFormat

IAudioClient::GetService

WASAPI