Compartir a través de


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