Метод IAudioSessionControl::SetGroupingParam (audiopolicy.h)
Метод SetGroupingParam назначает сеанс группе сеансов.
Синтаксис
HRESULT SetGroupingParam(
[in] LPCGUID Override,
[in] LPCGUID EventContext
);
Параметры
[in] Override
Новый параметр группирования. Этот параметр должен быть допустимым указателем, не имеющим значения NULL , на GUID параметра группировки. Дополнительные сведения см. в подразделе "Примечания".
[in] EventContext
Указатель на GUID контекста события. Если вызов этого метода создает событие изменения группировки, диспетчер сеансов отправляет уведомления всем клиентам, которые зарегистрировали интерфейсы IAudioSessionEvents с диспетчером сеансов. Диспетчер сеансов включает значение указателя EventContext с каждым уведомлением. Получив уведомление, клиент может определить, является ли он или другой клиент источником события, проверив значение EventContext . Эта схема зависит от того, выбирает клиент значение для этого параметра, уникальное для всех клиентов в сеансе. Если вызывающий объект предоставляет указатель NULL для этого параметра, метод уведомления клиента получает указатель контекста NULL .
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, но не ограничиваются ими, значения, показанные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Группирование параметров имеет значение NULL. |
|
Устройство конечной точки звука было отключено, или звуковое оборудование или связанные аппаратные ресурсы были перенастроены, отключены, удалены или иным образом стали недоступными для использования. |
|
Аудиослужба Windows не запущена. |
Комментарии
Клиент вызывает этот метод, чтобы изменить параметр группирования сеанса. Все звуковые сеансы с одинаковым значением параметра группирования находятся под управлением одного ползунка уровня громкости в системной программе управления громкости Sndvol. Дополнительные сведения см. в разделе Параметры группирования.
Клиент может получить текущий параметр группировки для сеанса, вызвав метод IAudioSessionControl::GetGroupingParam .
Если клиент никогда не вызывал SetGroupingParam для назначения параметра группировки сеансу, сеанс не принадлежит ни к одному из групп. Сеанс, который не принадлежит ни к одной группе, имеет собственный выделенный ползунок уровня громкости в программе Sndvol.
Требования
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | audiopolicy.h |
См. также раздел
Интерфейс IAudioSessionControl