ISimpleAudioVolume::SetMute 方法 (audioclient.h)
SetMute方法會設定音訊會話的靜音狀態。
語法
HRESULT SetMute(
[in] const BOOL bMute,
[in] LPCGUID EventContext
);
參數
[in] bMute
新的靜音狀態。 TRUE 會啟用靜音。 FALSE 會停用靜音。
[in] EventContext
事件內容 GUID 的指標。 如果呼叫這個方法會產生磁片區變更事件,會話管理員會傳送通知給已向會話管理員註冊 IAudioSessionEvents 介面的所有用戶端。 會話管理員會在每個通知中包含 EventCoNtext 指標值。 收到通知時,用戶端可以藉由檢查 EventCoNtext 值來判斷它或另一個用戶端是否為事件的來源。 此配置取決於用戶端選取這個參數的值,這個參數在會話中的所有用戶端之間是唯一的。 如果呼叫端提供此參數的 Null 指標,則用戶端的通知方法會收到 Null 內容指標。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括但不限於下表所示的值。
傳回碼 | Description |
---|---|
|
音訊端點裝置已解除叢集,或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。 |
|
Windows 音訊服務未執行。 |
備註
只有在方法呼叫將會話的靜音狀態從停用變更為已啟用,或從已啟用變更為停用時,這個方法才會產生磁片區變更事件。 例如,如果在呼叫發生時啟用靜音,而且呼叫會啟用靜音,則不會產生任何事件。
這個方法會將相同的靜音狀態套用至音訊會話中的所有通道。 端點裝置一律會在會話中的所有通道上統一套用靜音。 沒有 IChannelAudioVolume 方法可用來設定個別通道的靜音狀態。
用戶端可以藉由呼叫 SimpleAudioVolume::GetMute 方法來取得音訊會話的靜音狀態。
規格需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | audioclient.h |