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
AUDCLNT_E_DEVICE_INVALIDATED	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.
AUDCLNT_E_SERVICE_NOT_RUNNING	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

Interfaccia ISimpleAudioVolume

ISimpleAudioVolume::GetMute