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

El método GetVolumeStepInfo obtiene información sobre el paso actual del intervalo de volúmenes.

Sintaxis

HRESULT GetVolumeStepInfo(
  [out] UINT *pnStep,
  [out] UINT *pnStepCount
);

Parámetros

[out] pnStep

Puntero a una variable UINT en la que el método escribe el índice del paso actual. Este índice es un valor del intervalo comprendido entre 0 y *pStepCount– 1, donde 0 representa el nivel de volumen mínimo y *pStepCount– 1 representa el nivel máximo.

[out] pnStepCount

Puntero a una variable UINT en la que el método escribe el número de pasos en el intervalo de volúmenes. Este número permanece constante durante la vigencia de la instancia de interfaz IAudioEndpointVolume .

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

Este método representa el nivel de volumen de la secuencia de audio que entra o sale del dispositivo de punto de conexión de audio como un índice o "paso" en un intervalo de niveles de volumen discretos. El valor de salida *pnStepCount es el número de pasos del intervalo. El valor de salida *pnStep es el índice de paso del nivel de volumen actual. Si el número de pasos es n = *pnStepCount, el índice de pasos *pnStep puede asumir valores de 0 (volumen mínimo) a n – 1 (volumen máximo).

En el intervalo comprendido entre 0 y n – 1, 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, GetVolumeStepInfo define la relación de índice 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.

Las aplicaciones de audio pueden llamar a los métodos IAudioEndpointVolume::VolumeStepUp e IAudioEndpointVolume::VolumeStepDown para aumentar o reducir el nivel de volumen en un intervalo. En primer lugar, cualquiera de los métodos calcula el nivel de volumen idealizado que corresponde al siguiente punto de la curva con cinta de audio. A continuación, el método selecciona la configuración del volumen del punto de conexión que es la mejor aproximación al nivel idealizado. Para obtener el intervalo y la granularidad de la configuración del volumen del punto de conexión, llame al método IEndpointVolume::GetVolumeRange . Si el dispositivo de punto de conexión de audio implementa un control de volumen de hardware, GetVolumeRange describe la configuración del volumen de hardware. De lo contrario, endpointVolume API implementa el control de volumen del punto de conexión en software y GetVolumeRange describe la configuración de volumen del control implementado por software.

Requisitos

Consulte también

IAudioEndpointVolume (interfaz)

IAudioEndpointVolume::VolumeStepDown

IAudioEndpointVolume::VolumeStepUp