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 |