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

另請參閱

IAudioSessionEvents 介面

ISimpleAudioVolume：：SetMasterVolume

ISimpleAudioVolume：：SetMute