IAudioClient 介面 (audioclient.h)

IAudioClient 介面可讓用戶端針對共用) 模式數據流) 或音訊端點裝置 (的音頻端點裝置硬體緩衝區，建立和初始化音訊應用程式和音訊引擎之間的音訊數據流 (。 用戶端會依照下列步驟取得音訊端點裝置的 IAudioClient 介面參考：

1. 藉由使用 IMMDevice 介面中所述的其中一種技術，取得音訊端點裝置 之 IMMDevice 介面的參考。
2. 呼叫 IMMDevice：：Activate 方法，並將參數 iid 設定為 REFIID IID_IAudioClient。

使用這個介面的應用程式線程必須針對 COM 初始化。 如需 COM 初始化的詳細資訊，請參閱 Windows SDK 檔中 的 CoInitializeEx 函式描述。

如需使用 IAudioClient 介面的程式代碼範例，請參閱下列主題：

• 轉譯 Stream
• 擷取 Stream
• 獨佔模式數據流

繼承

IAudioClient 介面繼承自 IUnknown 介面。 IAudioClient 也有下列類型的成員：

方法

IAudioClient 介面具有這些方法。

IAudioClient：：GetBufferSize GetBufferSize 方法會擷取端點緩衝區的最大容量 (大小) 。
IAudioClient：：GetCurrentPadding GetCurrentPadding 方法會擷取端點緩衝區中填補的框架數目。
IAudioClient：：GetDevicePeriod GetDevicePeriod 方法會擷取定期間隔的長度，以分隔端點緩衝區中數據上音訊引擎所傳遞的連續處理。
IAudioClient：：GetMixFormat GetMixFormat 方法會擷取音訊引擎用於其共用模式數據流內部處理的數據流格式。
IAudioClient：：GetService GetService 方法會從音訊客戶端物件存取其他服務。
IAudioClient：：GetStreamLatency GetStreamLatency 方法會擷取目前數據流的最大延遲，而且可以在數據流初始化之後隨時呼叫。
IAudioClient：：Initialize Initialize 方法會初始化音頻數據流。
IAudioClient：：IsFormatSupported IsFormatSupported 方法會指出音訊端點裝置是否支援特定的數據流格式。
IAudioClient：：Reset Reset 方法會重設音訊數據流。
IAudioClient：：SetEventHandle SetEventHandle 方法會設定當用戶端準備好處理音訊緩衝區時，系統發出訊號的事件句柄。
IAudioClient：：Start Start 方法會啟動音訊數據流。
IAudioClient：：Stop Stop 方法會停止音訊數據流。

備註

注意在 Windows 8 中，第一次使用 IAudioClient 來存取音訊裝置應該位於 STA 線程上。 來自 MTA 線程的呼叫可能會導致未定義的行為。

 

規格需求

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	audioclient.h

另請參閱

核心音訊介面

IMMDevice：：Activate

WASAPI