Compartir a través de

Método IAudioSessionControl::GetGroupingParam (audiopolicy.h)

  • Artículo

El método GetGroupingParam recupera el parámetro de agrupación de la sesión de audio.

Sintaxis

HRESULT GetGroupingParam(
  [out] GUID *pRetVal
);

Parámetros

[out] pRetVal

Puntero de salida para el GUID de parámetro de agrupación. Este parámetro debe ser un puntero válido que no sea NULL a una variable GUID asignada por el autor de la llamada. El método escribe el parámetro de agrupación en esta variable.

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
E_POINTER
 El parámetro pRetVal es NULL.
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.

Comentarios

Todas las sesiones de audio que tienen el mismo valor de parámetro de agrupación están bajo el control del mismo control deslizante de nivel de volumen en el programa de control de volumen del sistema, Sndvol. Para obtener más información, vea Agrupar parámetros.

Un cliente puede llamar al método IAudioSessionControl::SetGroupingParam para cambiar el parámetro de agrupación de una sesión.

Si un cliente nunca ha llamado a SetGroupingParam para asignar un parámetro de agrupación a una sesión de audio, el valor del parámetro de agrupación de la sesión se GUID_NULL de forma predeterminada y una llamada a GetGroupingParam recupera este valor. Un valor de parámetro de agrupación de GUID_NULL indica que la sesión no pertenece a ninguna agrupación. En ese caso, la sesión tiene su propio control deslizante de nivel de volumen en el programa Sndvol.

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

IAudioSessionControl (Interfaz)

IAudioSessionControl::SetGroupingParam