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 |