(audioclient.h) IAudioCaptureClient 介面

IAudioCaptureClient 介面可讓用戶端從擷取端點緩衝區讀取輸入數據。 用戶端會呼叫 IAudioClient::GetService 方法,並將參數 riid 設定為 REFIID IID_IAudioCaptureClient,以取得數據流物件上 IAudioCaptureClient 介面的參考。

此介面中的方法會管理包含擷取數據的數據封包移動。 數據封包的長度會以封包中的音訊畫面數表示。 音訊畫面格的大小是由 (或 CLIENTATEXTENS) IBLE 的 nBlockAlign 成員所指定,用戶端呼叫 IAudioClient::GetMixFormat 方法來取得該結構。 音訊畫面的位元組大小等於數據流中的通道數目乘以每個通道的樣本大小。 例如,16 位樣本的立體 (2 通道) 數據流的框架大小為四個字節。 封包一律包含音訊框架的整數。

釋放 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