IAudioClient 介面 (audioclient.h)
IAudioClient 介面可讓用戶端針對共用) 模式數據流) 或音訊端點裝置 (的音頻端點裝置硬體緩衝區,建立和初始化音訊應用程式和音訊引擎之間的音訊數據流 (。 用戶端會依照下列步驟取得音訊端點裝置的 IAudioClient 介面參考:
- 藉由使用 IMMDevice 介面中所述的其中一種技術,取得音訊端點裝置 之 IMMDevice 介面的參考。
- 呼叫 IMMDevice::Activate 方法,並將參數 iid 設定為 REFIID IID_IAudioClient。
使用這個介面的應用程式線程必須針對 COM 初始化。 如需 COM 初始化的詳細資訊,請參閱 Windows SDK 檔中 的 CoInitializeEx 函式描述。
如需使用 IAudioClient 介面的程式代碼範例,請參閱下列主題:
繼承
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 |