Metodo IAudioEndpointVolume::SetMute (endpointvolume.h)

Il metodo SetMute imposta lo stato di modifica del flusso audio che entra o lascia il dispositivo dell'endpoint audio.

Sintassi

HRESULT SetMute(
  [in] BOOL    bMute,
  [in] LPCGUID pguidEventContext
);

Parametri

[in] bMute

Nuovo stato di modifica. Se bMute è TRUE, il metodo disattiva il flusso. Se FALSE, il metodo disattiva la disattivazione della modifica.

[in] pguidEventContext

Valore di contesto per il metodo IAudioEndpointVolumeCallback::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata SetMute modifica lo stato di modifica 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 evento per individuare se è l'origine dell'evento control-change o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, la routine di notifica riceve il valore GUID di contesto GUID_NULL.

Valore restituito

Se il metodo ha esito positivo e lo stato di modifica dello stato di modifica, il metodo restituisce S_OK. Se il metodo ha esito positivo e il nuovo stato di modifica è uguale allo stato di modifica precedente, il metodo restituisce S_FALSE. Se il metodo ha esito negativo, i possibili codici restituiti includono, ma non sono limitati a, i valori illustrati nella tabella seguente.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Per un esempio di codice che chiama SetMute, vedere Controlli volume endpoint.

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

Interfaccia IAudioEndpointVolumeCallback

IAudioEndpointVolumeCallback::OnNotify