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

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

  • Статья

Метод GetGroupingParam извлекает параметр группировки звукового сеанса.

Синтаксис

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

Параметры

[out] pRetVal

Выходной указатель для GUID параметра группировки. Этот параметр должен быть допустимым указателем guid, не имеющим значения NULL , на переменную GUID, выделенную вызывающим объектом. Метод записывает параметр группировки в эту переменную.

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

Если метод завершается успешно, возвращает значение 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
Header audiopolicy.h

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

Интерфейс IAudioSessionControl

IAudioSessionControl::SetGroupingParam