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