Método IAudioSessionManager2::GetSessionEnumerator (audiopolicy.h)

El método GetSessionEnumerator obtiene un puntero al objeto enumerador de sesión de audio.

Sintaxis

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

Parámetros

[out] SessionEnum

Recibe un puntero a la interfaz IAudioSessionEnumerator del objeto enumerador de sesión que el cliente puede usar para enumerar las sesiones de audio en el dispositivo de audio. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK.

Comentarios

El administrador de sesiones mantiene una colección de sesiones de audio que están activas en el dispositivo de audio consultando el motor de audio. GetSessionEnumerator crea un control de sesión para cada sesión de la colección. Para obtener una referencia a la interfaz IAudioSessionControl de la sesión de la colección enumerada, la aplicación debe llamar a IAudioSessionEnumerator::GetSession. Para obtener un ejemplo de código, vea IAudioSessionEnumerator Interface.

Es posible que el enumerador de sesión no tenga en cuenta las nuevas sesiones que se notifican a través de IAudioSessionNotification. Por lo tanto, si una aplicación se basa exclusivamente en el enumerador de sesión para obtener todas las sesiones de un punto de conexión de audio, es posible que los resultados no sean precisos. Para solucionarlo, la aplicación debe mantener manualmente una lista. Para obtener más información, vea IAudioSessionEnumerator.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	audiopolicy.h

Consulte también

IAudioSessionManager2