Метод IAudioSessionManager2::GetSessionEnumerator (audiopolicy.h)

Метод GetSessionEnumerator получает указатель на объект перечислителя звукового сеанса.

Синтаксис

HRESULT GetSessionEnumerator(
  [out] IAudioSessionEnumerator **SessionEnum
);

Параметры

[out] SessionEnum

Получает указатель на интерфейс IAudioSessionEnumerator объекта перечислителя сеансов, который клиент может использовать для перечисления звуковых сеансов на звуковом устройстве. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс. Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса.

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

Если метод завершается успешно, возвращает значение S_OK.

Комментарии

Диспетчер сеансов поддерживает коллекцию звуковых сеансов, которые активны на звуковом устройстве, запрашивая обработчик звука. GetSessionEnumerator создает элемент управления сеансом для каждого сеанса в коллекции. Чтобы получить ссылку на интерфейс IAudioSessionControl сеанса в перечисленной коллекции, приложение должно вызвать IAudioSessionEnumerator::GetSession. Пример кода см. в разделе Интерфейс IAudioSessionEnumerator.

Перечислитель сеансов может не знать о новых сеансах, о которых сообщается с помощью IAudioSessionNotification. Таким образом, если приложение использует исключительно перечислитель сеансов для получения всех сеансов для конечной точки звука, результаты могут быть неверными. Чтобы обойти эту проблему, приложение должно вручную вести список. Дополнительные сведения см. в разделе IAudioSessionEnumerator.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	audiopolicy.h

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

IAudioSessionManager2