Condividi tramite


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
E_OUTOFMEMORY
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

Interfaccia IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify