IAudioSessionEvents::OnSimpleVolumeChanged 方法 (audiopolicy.h)
OnSimpleVolumeChanged 方法會通知用戶端音訊會話的音量層級或靜音狀態已變更。
語法
HRESULT OnSimpleVolumeChanged(
[in] float NewVolume,
[in] BOOL NewMute,
[in] LPCGUID EventContext
);
參數
[in] NewVolume
音訊會話的新音量層級。 此參數是介於 0.0 到 1.0 之間的值,其中 0.0 是無聲,而 1.0 是完整磁碟區, (沒有衰減) 。
[in] NewMute
新的靜音狀態。 如果為 TRUE,則會啟用靜音。 如果 為 FALSE,則會停用靜音。
[in] EventContext
事件內容值。 這個值與呼叫端在變更會話音量層級或靜音狀態的呼叫中傳遞至 ISimpleAudioVolume::SetMasterVolume::SetSimpleAudioVolume::SetMute 的值相同。 如需詳細資訊,請參閱<備註>。
傳回值
如果方法成功,它會傳回 S_OK。 如果方法失敗,則會傳回錯誤碼。
備註
每次呼叫 ISimpleAudioVolume::SetMasterVolume 或 ISimpleAudioVolume::SetMute 方法時,會話管理員都會呼叫這個方法,以變更會話的磁碟區層級或靜音狀態。
EventContext 參數提供一種方法,讓用戶端區分它所起始的磁碟區或靜音變更,以及一個其他用戶端起始的變更。 呼叫 ISimpleAudioVolume::SetMasterVolume 或 ISimpleAudioVolume::SetMute 方法時,用戶端會傳入 EventContext 參數值,其 OnSimpleVolumeChanged 方法的實作可以辨識。
如需實作 IAudioSessionEvents 介面中方法的程式代碼範例,請參閱 音訊會話事件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | audiopolicy.h |