Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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