Metodo ISimpleAudioVolume::SetMute (audioclient.h)
Il metodo SetMute imposta lo stato di disattivazione per la sessione audio.
Sintassi
HRESULT SetMute(
[in] const BOOL bMute,
[in] LPCGUID EventContext
);
Parametri
[in] bMute
Nuovo stato di disattivazione. TRUE abilita la disattivazione. FALSE disabilita la disattivazione dell'opzione.
[in] EventContext
Puntatore al GUID del contesto dell'evento. Se una chiamata a questo metodo genera un evento di modifica del volume, il gestore della sessione invia notifiche a tutti i client che hanno registrato interfacce IAudioSessionEvents con la gestione sessione. La gestione sessione include il valore del puntatore EventContext con ogni notifica. Dopo aver ricevuto una notifica, un client può determinare se è l'origine dell'evento o un altro client controllando il valore EventContext . Questo schema dipende dal client che seleziona un valore per questo parametro univoco tra tutti i client nella sessione. 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 |
|---|---|
|
Il dispositivo endpoint audio è stato scollegato oppure l'hardware audio o le risorse hardware associate sono state riconfigurate, disabilitate, rimosse o altrimenti non disponibili per l'uso. |
|
Il servizio audio di Windows non è in esecuzione. |
Commenti
Questo metodo genera un evento di modifica del volume solo se la chiamata al metodo modifica lo stato di disattivazione della sessione da disabilitato a abilitato o da abilitato a disabilitato. Ad esempio, se la disattivazione è abilitata quando si verifica la chiamata e la chiamata abilita la disattivazione, non viene generato alcun evento.
Questo metodo applica lo stesso stato di disattivazione a tutti i canali nella sessione audio. Il dispositivo endpoint applica sempre la disattivazione uniforme in tutti i canali della sessione. Non sono disponibili metodi IChannelAudioVolume per impostare gli stati di disattivazione dei singoli canali.
Il client può ottenere lo stato di disattivazione della sessione audio chiamando il metodo SimpleAudioVolume::GetMute .
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 | audioclient.h |
Vedi anche
Interfaccia IAudioSessionEvents
Interfaccia IChannelAudioVolume