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

El método VolumeStepUp incrementa, 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 VolumeStepUp(
  [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 VolumeStepUp 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 él u otro cliente 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 posibles códigos de retorno incluyen, pero no están limitados a, 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 alto del intervalo de volúmenes, la llamada a VolumeStepUp 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 uniformes de volumen en amplitud de señal lineal o decibelios. En Windows Vista, VolumeStepUp define la relación de í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 de audio-tapered.

Requisitos

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolume::GetVolumeStepInfo

IAudioEndpointVolumeCallback (Interfaz)

IAudioEndpointVolumeCallback::OnNotify