共用方式為

IAudioSessionControl：：SetGroupingParam 方法 (audiopolicy.h)

  • 發行項

SetGroupingParam方法會將會話指派給會話群組。

語法

HRESULT SetGroupingParam(
  [in] LPCGUID Override,
  [in] LPCGUID EventContext
);

參數

[in] Override

新的群組參數。 此參數必須是群組參數 GUID 的有效非Null 指標。 如需詳細資訊，請參閱＜備註＞。

[in] EventContext

事件內容 GUID 的指標。 如果呼叫這個方法會產生群組變更事件，會話管理員會傳送通知給已向會話管理員註冊 IAudioSessionEvents 介面的所有用戶端。 會話管理員會在每個通知中包含 EventCoNtext 指標值。 收到通知時，用戶端可以藉由檢查 EventCoNtext 值來判斷它或另一個用戶端是否為事件的來源。 此配置取決於用戶端選取這個參數的值，這個參數在會話中的所有用戶端之間是唯一的。 如果呼叫端提供此參數的 Null 指標，則用戶端的通知方法會收到 Null 內容指標。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括但不限於下表所示的值。

傳回碼 Description
E_POINTER
 參數 群組 為 Null。
AUDCLNT_E_DEVICE_INVALIDATED
 音訊端點裝置已解除叢集，或音訊硬體或相關聯的硬體資源已重新設定、停用、移除或無法使用。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows 音訊服務未執行。

備註

用戶端會呼叫這個方法來變更會話的群組參數。 所有具有相同群組參數值的音訊會話都位於系統音量控制程式 Sndvol 中相同音量層級滑杆的控制之下。 如需詳細資訊，請參閱 群組參數。

用戶端可以藉由呼叫 IAudioSessionControl：：GetGroupingParam 方法來取得會話目前的群組參數。

如果用戶端從未呼叫 SetGroupingParam 將群組參數指派給會話，會話就不屬於任何群組。 不屬於任何群組的會話在 Sndvol 程式中都有自己的專用磁片區層級滑杆。

規格需求

   
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 audiopolicy.h

另請參閱

IAudioSessionControl 介面

IAudioSessionControl：：GetGroupingParam

IAudioSessionEvents 介面