Método IAudioStreamVolume::GetAllVolumes (audioclient.h)

  • Artículo

El método GetAllVolumes recupera los niveles de volumen de todos los canales de la secuencia de audio.

Sintaxis

HRESULT GetAllVolumes(
  [in]  UINT32 dwCount,
  [out] float  *pfVolumes
);

Parámetros

[in] dwCount

Número de elementos de la matriz pfVolumes . El parámetro dwCount debe ser igual al número de canales en formato de secuencia. Para obtener el número de canales, llame al método IAudioStreamVolume::GetChannelCount .

[out] pfVolumes

Puntero a una matriz de niveles de volumen para los canales de la secuencia de audio. Este parámetro apunta a una matriz float asignada por el autor de la llamada en la que el método escribe los niveles de volumen de los canales individuales. Los niveles de volumen están comprendidos entre 0,0 y 1,0.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto Descripción
E_INVALIDARG
 El parámetro dwCount no es igual al número de canales de la secuencia.
E_POINTER
 El parámetro pfVolumes 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 no están disponibles para su uso.
AUDCLNT_E_SERVICE_NOT_RUNNING
 El servicio de audio de Windows no se está ejecutando.

Comentarios

Los clientes pueden llamar al método IAudioStreamVolume::SetAllVolumes o IAudioStreamVolume::SetChannelVolume para establecer los niveles de volumen por canal en una secuencia de audio.

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 audioclient.h

Consulte también

IAudioStreamVolume (interfaz)

IAudioStreamVolume::GetChannelCount

IAudioStreamVolume::SetAllVolumes

IAudioStreamVolume::SetChannelVolume