IAudioSessionEvents::OnDisplayNameChanged-Methode (audiopolicy.h)
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 |