IAudioSessionManager2::UnregisterDuckNotification-Methode (audiopolicy.h)

Die UnregisterDuckNotification-Methode löscht eine vorherige Registrierung der Anwendung, um Benachrichtigungen zu empfangen.

Syntax

HRESULT UnregisterDuckNotification(
  IAudioVolumeDuckNotification *duckNotification
);

Parameter

duckNotification

Zeiger auf die IAudioVolumeDuckNotification-Schnittstelle , die von der Anwendung implementiert wird. Übergeben Sie den gleichen Schnittstellenzeiger, der an den Sitzungs-Manager in einem vorherigen Aufruf der IAudioSessionManager2::RegisterDuckNotification-Methode angegeben wurde. Wenn die UnregisterDuckNotification-Methode erfolgreich ist, ruft sie die Release-Methode auf der IAudioVolumeDuckNotification-Schnittstelle der Anwendung auf.

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ückgabewert	Beschreibung
E_POINTER	duckNotification ist NULL.

Hinweise

Die Anwendung ruft diese Methode auf, wenn sie keine Benachrichtigungen mehr empfangen muss. Die UnregisterDuckNotification-Methode entfernt die Registrierung einer IAudioVolumeDuckNotification-Schnittstelle , die die Anwendung zuvor beim Sitzungs-Manager registriert hat, indem die IAudioSessionManager2::RegisterDuckNotification-Methode aufgerufen wird.

Nachdem die Anwendung UnregisterDuckNotification aufgerufen hat, werden alle ausstehenden Ereignisse nicht an die Anwendung gemeldet.

Anforderungen

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

Weitere Informationen

Standard-Ducking-Erfahrung

Abrufen von Duckingereignissen

IAudioSessionManager2