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 |
|---|---|
|
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