Metodo IAudioEndpointVolume::VolumeStepUp (endpointvolume.h)

Il metodo VolumeStepUp incrementa, per un passaggio, il livello di volume del flusso audio che entra o lascia il dispositivo dell'endpoint audio.

Sintassi

HRESULT VolumeStepUp(
  [in] LPCGUID pguidEventContext
);

Parametri

[in] pguidEventContext

Valore di contesto per il metodo IAudioEndpointVolumeCallback::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata VolumeStepUp 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ò controllare il GUID del contesto 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 codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Per ottenere il passaggio del volume corrente e il numero totale di passaggi nell'intervallo di volumi, chiamare il metodo IAudioEndpointVolume::GetVolumeStepInfo .

Se il livello del volume è già al passaggio più alto nell'intervallo di volumi, la chiamata a VolumeStepUp 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 di segnale lineare o decibel. In Windows Vista VolumeStepUp definisce la relazione di indice passo 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.

Requisiti

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