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

Artículo
02/26/2024

El método GetSimpleAudioVolume recupera un control de volumen de audio simple.

Sintaxis

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

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 si la solicitud es para una sesión entre procesos. Se establece en TRUE si la sesión es entre procesos. Se establece en FALSE si la sesión no es entre procesos.

[out] AudioVolume

Puntero a una variable de puntero en la que el método escribe un puntero en la interfaz ISimpleAudioVolume del objeto de control de volumen de audio. Esta interfaz representa el control de volumen de audio simple para el proceso actual. 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 Activate , *AudioVolume 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 AudioVolume es NULL.
E_MEMORY	Memoria insuficiente

Requisitos

Requisito	Value
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

Interfaz IAudioSessionManager

ISimpleAudioVolume (interfaz)