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 |