Metodo IAudioEndpointVolume::VolumeStepDown (endpointvolume.h)
Il metodo VolumeStepDown decrementa, di un passaggio, il livello di volume del flusso audio che entra o lascia il dispositivo endpoint audio.
Sintassi
HRESULT VolumeStepDown(
[in] LPCGUID pguidEventContext
);
Parametri
[in] pguidEventContext
Valore di contesto per il metodo IAudioEndpointVolumeCallback::OnNotify . Questo parametro punta a un GUID del contesto di evento. Se la chiamata VolumeStepDown modifica il livello di volume dell'endpoint, tutti i client che hanno registrato interfacce IAudioEndpointVolumeCallback con tale endpoint riceveranno notifiche. Nell'implementazione del metodo OnNotify , un client può esaminare il GUID del contesto di evento per individuare se è l'origine dell'evento di modifica del volume o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, il metodo di notifica del client riceve un puntatore di contesto NULL .
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Memoria insufficiente. |
Commenti
Per ottenere il passaggio corrente del volume e il numero totale di passaggi nell'intervallo di volumi, chiamare il metodo IAudioEndpointVolume::GetVolumeStepInfo .
Se il livello del volume è già al passaggio più basso nell'intervallo di volumi, la chiamata a VolumeStepDown non ha alcun effetto e restituisce il codice di stato S_OK.
Gli intervalli successivi tra i passaggi adiacenti non rappresentano necessariamente incrementi uniformi del volume in ampiezza del segnale lineare o decibel. In Windows Vista VolumeStepDown definisce la relazione tra indice passaggio e livello di volume (ampiezza del segnale) come curva con taper audio. Si noti che la forma della curva potrebbe cambiare nelle versioni future di Windows. Per altre informazioni sulle curve audio tapered, vedi Controlli volume con tocco audio.
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::GetVolumeStepInfo