Método IAudioSessionManager::GetAudioSessionControl (audiopolicy.h)

  • Artículo

El método GetAudioSessionControl recupera un control de sesión de audio.

Sintaxis

HRESULT GetAudioSessionControl(
  [in]  LPCGUID              AudioSessionGuid,
  [in]  DWORD                StreamFlags,
  [out] IAudioSessionControl **SessionControl
);

Parámetros

[in] AudioSessionGuid

Puntero a un GUID de sesión. Si el GUID no identifica una sesión que se ha abierto anteriormente, la llamada abre una sesión nueva pero vacía. El programa Sndvol no muestra un control de nivel de volumen para una sesión a menos que contenga una o varias secuencias activas. Si este parámetro es NULL o apunta al valor GUID_NULL, el método asigna la secuencia a la sesión predeterminada.

[in] StreamFlags

Especifica el estado de las marcas de la secuencia de audio.

[out] SessionControl

Puntero a una variable de puntero en la que el método escribe un puntero en la interfaz IAudioSessionControl del objeto de control de sesión de audio. El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada, *SessionControl es NULL.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
AUDCLNT_E_NOT_INITIALIZED
 La secuencia de audio no se ha inicializado correctamente.
AUDCLNT_E_DEVICE_INVALIDATED
 El dispositivo de punto de conexión de audio se ha desconectado o el hardware de audio o los recursos de hardware asociados se han reconfigurado, deshabilitado, quitado o dejado de estar disponible para su uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
 El servicio de audio de Windows no se está ejecutando.
E_POINTER
 El parámetro SessionControl es NULL.
E_MEMORY
 Memoria insuficiente

Comentarios

Para obtener un ejemplo de código que llama a este método, vea Eventos de audio para aplicaciones de audio heredadas.

Requisitos

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

Consulte también

IAudioSessionControl (Interfaz)

Interfaz IAudioSessionManager