IAudioSessionEvents::OnIconPathChanged-Methode (audiopolicy.h)

Die OnIconPathChanged-Methode benachrichtigt den Client, dass sich das Anzeigesymbol für die Sitzung geändert hat.

Syntax

HRESULT OnIconPathChanged(
  [in] LPCWSTR NewIconPath,
  [in] LPCGUID EventContext
);

Parameter

[in] NewIconPath

Der Pfad für das neue Anzeigesymbol für die Sitzung. Dieser Parameter verweist auf eine Zeichenfolge, die den Pfad für das neue Symbol enthält. Der Zeichenfolgenzeiger bleibt nur für die Dauer des Aufrufs gültig.

[in] EventContext

Der Ereigniskontextwert. Dies ist der gleiche Wert, den der Aufrufer in dem Aufruf, der das Anzeigesymbol für die Sitzung geändert hat, an IAudioSessionControl::SetIconPath übergeben hat. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Der Sitzungs-Manager ruft diese Methode jedes Mal auf, wenn ein Aufruf der IAudioSessionControl::SetIconPath-Methode das Anzeigesymbol für die Sitzung ändert. Das Sndvol-Programm verwendet das Anzeigesymbol einer Sitzung, um den Volumeschieberegler für die Sitzung zu bezeichnen.

Der EventContext-Parameter bietet einem Client eine Möglichkeit, zwischen einer Anzeigesymboländerung, die er initiiert hat, und einer Änderung zu unterscheiden, die von einem anderen Client initiiert wurde. Beim Aufrufen der IAudioSessionControl::SetIconPath-Methode übergibt ein Client einen EventContext-Parameterwert , den die Implementierung der OnIconPathChanged-Methode erkennen kann.

Ein Codebeispiel, das die Methoden in der IAudioSessionEvents-Schnittstelle implementiert, finden Sie unter Audiositzungsereignisse.

Anforderungen

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

Weitere Informationen

IAudioSessionControl::SetIconPath

IAudioSessionEvents-Schnittstelle