Метод IAudioSessionControl::SetGroupingParam (audiopolicy.h)

Статья
08/22/2023

Метод SetGroupingParam назначает сеанс группе сеансов.

Синтаксис

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

Параметры

[in] Override

Новый параметр группирования. Этот параметр должен быть допустимым указателем, не имеющим значения NULL , на GUID параметра группировки. Дополнительные сведения см. в подразделе "Примечания".

[in] EventContext

Указатель на GUID контекста события. Если вызов этого метода создает событие изменения группировки, диспетчер сеансов отправляет уведомления всем клиентам, которые зарегистрировали интерфейсы IAudioSessionEvents с диспетчером сеансов. Диспетчер сеансов включает значение указателя EventContext с каждым уведомлением. Получив уведомление, клиент может определить, является ли он или другой клиент источником события, проверив значение EventContext . Эта схема зависит от того, выбирает клиент значение для этого параметра, уникальное для всех клиентов в сеансе. Если вызывающий объект предоставляет указатель NULL для этого параметра, метод уведомления клиента получает указатель контекста NULL .

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.

Код возврата	Описание
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
Header	audiopolicy.h

См. также раздел

Интерфейс IAudioSessionControl

IAudioSessionControl::GetGroupingParam

Интерфейс IAudioSessionEvents

Поделиться через