IAudioEndpointVolume::SetMute-Methode (endpointvolume.h)

Die SetMute-Methode legt den Stummschaltungsstatus des Audiodatenstroms fest, der in das Audioendpunktgerät eintritt oder dieses verlässt.

Syntax

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

Parameter

[in] bMute

Der neue Stummschaltungszustand. Wenn bMuteTRUE ist, wird der Stream von der Methode stummgeschaltet. Bei FALSE deaktiviert die Methode die Stummschaltung.

[in] pguidEventContext

Kontextwert für die IAudioEndpointVolumeCallback::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetMute-Aufruf den Stummschaltungsstatus des Endpunkts ändert, erhalten alle Clients, die IAudioEndpointVolumeCallback-Schnittstellen mit diesem Endpunkt registriert haben, Benachrichtigungen. Bei der Implementierung der OnNotify-Methode kann ein Client die Ereigniskontext-GUID überprüfen, um zu ermitteln, ob er oder ein anderer Client die Quelle des Steuerelementänderungsereignisses ist. Wenn der Aufrufer einen NULL-Zeiger für diesen Parameter bereitstellt, empfängt die Benachrichtigungsroutine den Kontext-GUID-Wert GUID_NULL.

Rückgabewert

Wenn die Methode erfolgreich ist und sich der Stummschaltungszustand ändert, gibt die Methode S_OK zurück. Wenn die Methode erfolgreich ist und der neue Stummschaltungszustand mit dem vorherigen Stummschaltungszustand identisch ist, gibt die Methode S_FALSE zurück. Wenn die Methode fehlschlägt, können mögliche Rückgabecodes die werte in der folgenden Tabelle enthalten, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Ein Codebeispiel, das SetMute aufruft, finden Sie unter Endpunktvolumesteuerelemente.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	endpointvolume.h

Weitere Informationen

IAudioEndpointVolume-Schnittstelle

IAudioEndpointVolumeCallback-Schnittstelle

IAudioEndpointVolumeCallback::OnNotify