Share via

IAudioSessionEvents::OnDisplayNameChanged-Methode (audiopolicy.h)

  • Artikel

Die OnDisplayNameChanged-Methode benachrichtigt den Client, dass der Anzeigename für die Sitzung geändert wurde.

Syntax

HRESULT OnDisplayNameChanged(
  [in] LPCWSTR NewDisplayName,
  [in] LPCGUID EventContext
);

Parameter

[in] NewDisplayName

Der neue Anzeigename für die Sitzung. Dieser Parameter verweist auf eine mit NULL endende Breitzeichenzeichenfolge, die den neuen Anzeigenamen enthält. Die Zeichenfolge bleibt für die Dauer des Aufrufs gültig.

[in] EventContext

Der Ereigniskontextwert. Dies ist der gleiche Wert, den der Aufrufer in dem Aufruf, der den Anzeigenamen für die Sitzung geändert hat, an IAudioSessionControl::SetDisplayName ü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::SetDisplayName-Methode den Anzeigenamen der Sitzung ändert. Das Sndvol-Programm verwendet den Anzeigenamen einer Sitzung, um den Volumeschieberegler für die Sitzung zu bezeichnen.

Der EventContext-Parameter stellt ein Mittel für einen Client bereit, um zwischen einer Anzeigenamenänderung zu unterscheiden, die er initiiert hat, und einer Änderung, die von einem anderen Client initiiert wurde. Beim Aufrufen der IAudioSessionControl::SetDisplayName-Methode übergibt ein Client einen EventContext-Parameterwert , den die Implementierung der OnDisplayNameChanged-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::SetDisplayName

IAudioSessionEvents-Schnittstelle