共用方式為


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

另請參閱

IAudioSessionControl::SetGroupingParam

IAudioSessionEvents 介面