Interfaz IAudioSessionControl (audiopolicy.h)

La interfaz IAudioSessionControl permite a un cliente configurar los parámetros de control para una sesión de audio y supervisar eventos en la sesión. El método IAudioClient::Initialize inicializa un objeto de secuencia y asigna la secuencia a una sesión de audio. El cliente obtiene una referencia a la interfaz IAudioSessionControl en un objeto de secuencia llamando al método IAudioClient::GetService con el parámetro riid establecido en REFIID IID_IAudioSessionControl.

Como alternativa, un cliente puede obtener la interfaz IAudioSessionControl de una sesión existente sin tener que crear primero un objeto de secuencia y agregar la secuencia a la sesión. En su lugar, el cliente llama al método IAudioSessionManager::GetAudioSessionControl con el parámetro AudioSessionGuid establecido en el GUID de sesión.

El cliente puede registrarse para recibir notificaciones del administrador de sesiones cuando los clientes cambian los parámetros de sesión a través de los métodos de la interfaz IAudioSessionControl .

Al liberar una instancia de interfaz IAudioSessionControl , el cliente debe llamar al método Release de la interfaz desde el mismo subproceso que la llamada a IAudioClient::GetService que creó el objeto.

La interfaz IAudioSessionControl controla una sesión de audio. Una sesión de audio es una colección de secuencias en modo compartido. Esta interfaz no funciona con secuencias en modo exclusivo.

Para obtener un ejemplo de código que usa la interfaz IAudioSessionControl , vea Eventos de audio para aplicaciones de audio heredadas.

Herencia

La interfaz IAudioSessionControl hereda de la interfaz IUnknown . IAudioSessionControl también tiene estos tipos de miembros:

Métodos

La interfaz IAudioSessionControl tiene estos métodos.

IAudioSessionControl::GetDisplayName El método GetDisplayName recupera el nombre para mostrar de la sesión de audio.
IAudioSessionControl::GetGroupingParam El método GetGroupingParam recupera el parámetro de agrupación de la sesión de audio.
IAudioSessionControl::GetIconPath El método GetIconPath recupera la ruta de acceso del icono de presentación de la sesión de audio.
IAudioSessionControl::GetState El método GetState recupera el estado actual de la sesión de audio.
IAudioSessionControl::RegisterAudioSessionNotification El método RegisterAudioSessionNotification registra al cliente para recibir notificaciones de eventos de sesión, incluidos los cambios en el estado de la secuencia.
IAudioSessionControl::SetDisplayName El método SetDisplayName asigna un nombre para mostrar a la sesión actual.
IAudioSessionControl::SetGroupingParam El método SetGroupingParam asigna una sesión a una agrupación de sesiones.
IAudioSessionControl::SetIconPath El método SetIconPath asigna un icono de presentación a la sesión actual.
IAudioSessionControl::UnregisterAudioSessionNotification El método UnregisterAudioSessionNotification elimina un registro anterior por parte del cliente para recibir notificaciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	audiopolicy.h

Consulte también

Interfaces de audio principales

IAudioClient::GetService

IAudioClient::Initialize

IAudioSessionManager::GetAudioSessionControl

WASAPI