Método IAudioStreamVolume::SetAllVolumes (audioclient.h)
El método SetAllVolumes establece los niveles de volumen individuales para todos los canales de la secuencia de audio.
Sintaxis
HRESULT SetAllVolumes(
[in] UINT32 dwCount,
[in] const float *pfVolumes
);
Parámetros
[in] dwCount
Número de elementos de la matriz pfVolumes . Este parámetro 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 .
[in] pfVolumes
Puntero a una matriz de niveles de volumen para los canales de la secuencia de audio. El parámetro dwCount especifica el número de elementos de la matriz pfVolumes. El autor de la llamada escribe el nivel de volumen de cada canal en el elemento de matriz cuyo índice coincide con el número de canal. Si el formato de secuencia tiene N canales, los canales se numeran de 0 a N– 1. Los niveles de volumen válidos 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 |
|---|---|
|
El parámetro dwCount no es igual al número de canales de la secuencia o el valor de un elemento de matriz pfVolumes no está en el intervalo de 0,0 a 1,0. |
|
El parámetro pfVolumes 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. |
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 |