Método IChannelAudioVolume::GetChannelVolume (audioclient.h)
El método GetChannelVolume recupera el nivel de volumen del canal especificado en la sesión de audio.
Sintaxis
HRESULT GetChannelVolume(
[in] UINT32 dwIndex,
[out] float *pfLevel
);
Parámetros
[in] dwIndex
Número de canal. Si el formato de secuencia de la sesión de audio tiene N canales, los canales se numeran de 0 a N– 1. Para obtener el número de canales, llame al método IChannelAudioVolume::GetChannelCount .
[out] pfLevel
Puntero a una variable float en la que el método escribe el nivel de volumen del canal especificado. El nivel de volumen está comprendido 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 |
|---|---|
|
El parámetro dwIndex se establece en un número de canal no válido. |
|
El parámetro pfLevel es NULL. |
|
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. |
|
El servicio de audio de Windows no se está ejecutando. |
Comentarios
Los clientes pueden llamar al método IChannelAudioVolume::SetAllVolumes o IChannelAudioVolume::SetChannelVolume para establecer los niveles de volumen por canal en una sesión de audio.
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 | audioclient.h |
Consulte también
IChannelAudioVolume (interfaz)
IChannelAudioVolume::GetChannelCount