Método IAudioEndpointVolume::VolumeStepDown (endpointvolume.h)

El método VolumeStepDown disminuye, en un paso, el nivel de volumen de la secuencia de audio que entra o sale del dispositivo de punto de conexión de audio.

Sintaxis

HRESULT VolumeStepDown(
  [in] LPCGUID pguidEventContext
);

Parámetros

[in] pguidEventContext

Valor de contexto del método IAudioEndpointVolumeCallback::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada VolumeStepDown cambia el nivel de volumen del punto de conexión, todos los clientes que han registrado interfaces IAudioEndpointVolumeCallback con ese punto de conexión recibirán notificaciones. En su implementación del método OnNotify , un cliente puede inspeccionar el GUID del contexto de eventos para detectar si es el origen del evento de cambio de volumen. Si el autor de la llamada proporciona un puntero NULL para este parámetro, el método de notificación del cliente recibe un puntero de contexto 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.

Comentarios

Para obtener el paso de volumen actual y el número total de pasos del intervalo de volúmenes, llame al método IAudioEndpointVolume::GetVolumeStepInfo .

Si el nivel de volumen ya está en el paso más bajo del intervalo de volúmenes, la llamada a VolumeStepDown no tiene ningún efecto y devuelve el código de estado S_OK.

Los intervalos sucesivos entre los pasos adyacentes no representan necesariamente incrementos de volumen uniformes en amplitud de señal lineal o decibelios. En Windows Vista, VolumeStepDown define la relación del índice de paso con el nivel de volumen (amplitud de señal) para que sea una curva con cinta de audio. Tenga en cuenta que la forma de la curva puede cambiar en versiones futuras de Windows. Para obtener más información sobre las curvas con cinta de audio, vea Controles de volumen con cinta de audio.

Requisitos

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolume::GetVolumeStepInfo

IAudioEndpointVolumeCallback (Interfaz)

IAudioEndpointVolumeCallback::OnNotify