IAudioVolumeDuckNotification::OnVolumeDuckNotification-Methode (audiopolicy.h)

Die OnVolumeDuckNotification-Methode sendet eine Benachrichtigung über ein ausstehendes System-Ducking-Ereignis. Weitere Informationen finden Sie unter Überlegungen zur Implementierung von Ducking-Benachrichtigungen.

Syntax

HRESULT OnVolumeDuckNotification(
  [in] LPCWSTR sessionID,
  [in] UINT32  countCommunicationSessions
);

Parameter

[in] sessionID

Eine Zeichenfolge, die die Sitzung instance Bezeichner der Kommunikationssitzung enthält, die das Auto-Ducking-Ereignis auslöst. Rufen Sie IAudioSessionControl2::GetSessionInstanceIdentifier auf, um den Sitzungsbezeichner instance abzurufen.

[in] countCommunicationSessions

Die Anzahl der aktiven Kommunikationssitzungen. Wenn n Sitzungen vorhanden sind, werden die Sitzungen von 0 bis –1 nummeriert.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

Hinweise

Nachdem die Anwendung ihre Implementierung der IAudioVolumeDuckNotification-Schnittstelle durch Aufrufen von IAudioSessionManager2::RegisterDuckNotification registriert hat, ruft der Sitzungs-Manager OnVolumeDuckNotification auf, wenn er eine Benachrichtigung senden möchte, wann das Ducking beginnt. Die Anwendung empfängt die Ereignisbenachrichtigungen in Form von Rückrufen.

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

IAudioVolumeDuckNotification

Verwenden eines Kommunikationsgeräts