IAudioMute::SetMute-Methode (devicetopology.h)

  • Artikel

Die SetMute-Methode aktiviert oder deaktiviert das Stummschaltungssteuerelement.

Syntax

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

Parameter

[in] bMuted

Der neue Stummschaltungszustand. Wenn bMutedTRUE (nonzero) ist, aktiviert die Methode die Stummschaltung. Bei FALSE deaktiviert die Methode die Stummschaltung.

[in] pguidEventContext

Kontextwert für die IControlChangeNotify::OnNotify-Methode . Dieser Parameter verweist auf eine Ereigniskontext-GUID. Wenn der SetMute-Aufruf den Status des Stummschaltungssteuerelements ändert, erhalten alle Clients, die IControlChangeNotify-Schnittstellen mit diesem Steuerelement 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 Benachrichtigungsmethode des Clients einen NULL-Kontextzeiger .

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_OUTOFMEMORY
 Nicht genügend Arbeitsspeicher.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IAudioMute-Schnittstelle