IAudioSessionControl::GetGroupingParam メソッド (audiopolicy.h)

  • [アーティクル]

GetGroupingParam メソッドは、オーディオ セッションのグループ化パラメーターを取得します。

構文

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

パラメーター

[out] pRetVal

grouping-parameter GUID の出力ポインター。 このパラメーターは、呼び出し元によって割り当てられた GUID 変数への有効な NULL 以外のポインターである必要があります。 メソッドは、グループ化パラメーターをこの変数に書き込みます。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
E_POINTER
 パラメーター pRetVal は NULL です。
AUDCLNT_E_DEVICE_INVALIDATED
 オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows オーディオ サービスが実行されていません。

注釈

同じグループ化パラメーター値を持つすべてのオーディオ セッションは、システム ボリューム制御プログラム Sndvol の同じボリューム レベル スライダーの制御下にあります。 詳細については、「 グループ化パラメーター」を参照してください。

クライアントは IAudioSessionControl::SetGroupingParam メソッドを 呼び出して、セッションのグループ化パラメーターを変更できます。

クライアントがオーディオ セッションにグループ化パラメーターを割り当てるために SetGroupingParam を呼び出したことがない場合、セッションのグループ化パラメーター値は既定でGUID_NULLされ、 GetGroupingParam の呼び出しによってこの値が取得されます。 GUID_NULLのグループ化パラメーター値は、セッションがグループ化に属していないことを示します。 その場合、セッションには Sndvol プログラムに独自のボリューム レベル スライダーがあります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー audiopolicy.h

こちらもご覧ください

IAudioSessionControl インターフェイス

IAudioSessionControl::SetGroupingParam