Перечисление AudioSessionState (audiosessiontypes.h)

Статья
08/22/2023

Перечисление AudioSessionState определяет константы, указывающие текущее состояние звукового сеанса.

Синтаксис

typedef enum _AudioSessionState {
  AudioSessionStateInactive,
  AudioSessionStateActive,
  AudioSessionStateExpired
} AudioSessionState;

Константы


`AudioSessionStateInactive` Звуковой сеанс неактивен. (Он содержит по крайней мере один поток, но ни один из потоков в сеансе в настоящее время не выполняется.)
`AudioSessionStateActive` Аудиосеанс активен. (Выполняется по крайней мере один из потоков в сеансе.)
`AudioSessionStateExpired` Срок действия звукового сеанса истек. (Он не содержит потоков.)

Когда клиент открывает сеанс путем назначения первого потока сеансу (путем вызова метода IAudioClient::Initialize ), начальное состояние сеанса неактивно. Состояние сеанса изменяется с неактивного на активное при запуске потока в сеансе (так как клиент вызвал метод IAudioClient::Start ). Сеанс меняется с активного на неактивный, когда клиент останавливает последний запущенный поток в сеансе (путем вызова метода IAudioClient::Stop ). Состояние сеанса меняется на истекший, когда клиент уничтожает последний поток в сеансе, освобождая все ссылки на объект потока.

Системная программа управления громкостем Sndvol отображает элементы управления громкостей как для активных, так и для неактивных сеансов. Sndvol прекращает отображение элемента управления громкости для сеанса при изменении состояния сеанса на истекший срок действия. Дополнительные сведения о Sndvol см. в разделе Аудиосеансы.

Методы IAudioSessionControl::GetState и IAudioSessionEvents::OnStateChanged используют константы, определенные в перечислении AudioSessionState .

Дополнительные сведения о состояниях сеанса см. в разделе Звуковые сеансы.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Верхняя часть	audiosessiontypes.h