AudioStateMonitorCallback-Rückruffunktion (audiostatemonitorapi.h)

Artikel
02/23/2024

Wird aufgerufen, wenn das System den Soundpegel der Audiodatenströme ändert, die von einem IAudioStateMonitor überwacht werden.

Syntax

AudioStateMonitorCallback Audiostatemonitorcallback;

void Audiostatemonitorcallback(
  [in]           IAudioStateMonitor *audioStateMonitor,
  [in, optional] void *context
)
{...}

Parameter

[in] audioStateMonitor

Der IAudioStateMonitor , bei dem der Rückruf registriert wurde.

[in, optional] context

Ein void-Zeiger, der auf Kontextinformationen verweist, die der Client im Aufruf von IAudioStateMonitor::RegisterCallback bereitgestellt hat.

Rückgabewert

Keine

Bemerkungen

Windows schaltet die Audiodatenströme als Reaktion auf Systemereignisse dynamisch stumm oder senkt sie. Beispielsweise kann die Lautstärke des Audiorenderingstreams einer Podcast-App verringert werden, während ein Alarm klingelt. Oder bei einer Audioaufzeichnungs-App kann der Aufnahmedatenstrom stummgeschaltet werden, wenn die App in den Hintergrund verschoben wird. Registrieren Sie eine Implementierung dieses Rückrufs mit einem Aufruf von IAudioStateMonitor::RegisterCallback , um Benachrichtigungen zu erhalten, wenn sich der Soundpegel für einen Stream ändert, und rufen Sie dann die IAudioStateMonitor::GetSoundLevel-Eigenschaft auf, um den neuen aktuellen Audiopegel zu bestimmen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Build 19043
Kopfzeile	audiostatemonitorapi.h

Freigeben über