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 メソッドを呼び出すと、クライアントは、OnGroupingParamChanged メソッドの実装で認識できる EventContext パラメーター値を渡します。

IAudioSessionEvents インターフェイスで メソッドを実装するコード例については、「オーディオ セッション イベント」を参照してください。

要件

こちらもご覧ください

IAudioSessionControl::SetGroupingParam

IAudioSessionEvents インターフェイス