Metodo IAudioEndpointVolume::GetVolumeStepInfo (endpointvolume.h)

Articolo
02/28/2024

Il metodo GetVolumeStepInfo ottiene informazioni sul passaggio corrente nell'intervallo di volumi.

Sintassi

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

Parametri

[out] pnStep

Puntatore a una variabile UINT in cui il metodo scrive l'indice del passaggio corrente. Questo indice è un valore compreso nell'intervallo compreso tra 0 e *pStepCount– 1, dove 0 rappresenta il livello minimo del volume e *pStepCount- 1 rappresenta il livello massimo.

[out] pnStepCount

Puntatore a una variabile UINT in cui il metodo scrive il numero di passaggi nell'intervallo di volumi. Questo numero rimane costante per la durata dell'istanza dell'interfaccia IAudioEndpointVolume .

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
E_POINTER	Il parametro pnStep e pnStepCount sono entrambi NULL.

Commenti

Questo metodo rappresenta il livello di volume del flusso audio che entra o lascia il dispositivo endpoint audio come indice o "passaggio" in un intervallo di livelli di volume discreti. Il valore di output *pnStepCount è il numero di passaggi nell'intervallo. Il valore di output *pnStep è l'indice di passaggio del livello del volume corrente. Se il numero di passaggi è n = *pnStepCount, l'indice passaggio *pnStep può assumere valori da 0 (volume minimo) a n - 1 (volume massimo).

Nell'intervallo compreso tra 0 e n - 1, gli intervalli successivi tra i passaggi adiacenti non rappresentano necessariamente incrementi uniformi del volume in ampiezza del segnale lineare o decibel. In Windows Vista, GetVolumeStepInfo definisce la relazione di indice a livello di volume (ampiezza del segnale) per essere una curva con tocco audio. Si noti che la forma della curva potrebbe cambiare nelle versioni future di Windows. Per altre informazioni sulle curve con taper audio, vedere Controlli volume con tocco audio.

Le applicazioni audio possono chiamare i metodi IAudioEndpointVolume::VolumeStepUp e IAudioEndpointVolume::VolumeStepDown per aumentare o ridurre il livello di volume per un intervallo. Entrambi i metodi calcolano prima il livello di volume idealizzato che corrisponde al punto successivo della curva con tocco audio. Successivamente, il metodo seleziona l'impostazione del volume dell'endpoint che è l'approssimazione migliore per il livello idealizzato. Per ottenere l'intervallo e la granularità delle impostazioni del volume dell'endpoint, chiamare il metodo IEndpointVolume::GetVolumeRange . Se il dispositivo endpoint audio implementa un controllo del volume hardware, GetVolumeRange descrive le impostazioni del volume hardware. In caso contrario, l'API EndpointVolume implementa il controllo del volume degli endpoint nel software e GetVolumeRange descrive le impostazioni del volume del controllo implementato dal software.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	endpointvolume.h

Vedi anche

Interfaccia IAudioEndpointVolume

IAudioEndpointVolume::VolumeStepDown

IAudioEndpointVolume::VolumeStepUp

Share via