IAudioSessionEvents::OnGroupingParamChanged 方法 (audiopolicy.h)
OnGroupingParamChanged 方法會通知用戶端會話的群組參數已變更。
語法
HRESULT OnGroupingParamChanged(
[in] LPCGUID NewGroupingParam,
[in] LPCGUID EventContext
);
參數
[in] NewGroupingParam
會話的新群組參數。 此參數指向 grouping-parameter GUID。
[in] EventContext
事件內容值。 這是呼叫端在變更會話群組參數的呼叫中傳遞至 IAudioSessionControl::SetGroupingParam 的相同值。 如需詳細資訊,請參閱<備註>。
傳回值
如果方法成功,它會傳回 S_OK。 如果方法失敗,則會傳回錯誤碼。
備註
每次呼叫 IAudioSessionControl::SetGroupingParam 方法時,會話管理員都會呼叫這個方法,變更會話的群組參數。
EventContext 參數提供一種方法,可讓用戶端區分它所起始的群組參數變更,以及一個其他用戶端起始的變更。 呼叫 IAudioSessionControl::SetGroupingParam 方法時,用戶端會傳入 EventContext 參數值,而其 實作 OnGroupingParamChanged 方法可以辨識。
如需實作 IAudioSessionEvents 介面中方法的程式代碼範例,請參閱 音訊會話事件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | audiopolicy.h |