IAudioStateMonitor interface (audiostatemonitorapi.h)
Provides APIs for querying the sound level of audio streams and for receiving notifications when the sound level changes.
Inheritance
The IAudioStateMonitor interface inherits from the IUnknown interface.
Methods
The IAudioStateMonitor interface has these methods.
| IAudioStateMonitor::GetSoundLevel Gets the current sound level for the audio streams associated with an IAudioStateMonitor. |
| IAudioStateMonitor::RegisterCallback Registers an implementation of AudioStateMonitorCallback that is called when the system changes the sound level of the audio streams being monitored by an IAudioStateMonitor. |
| IAudioStateMonitor::UnregisterCallback Unregisters an AudioStateMonitorCallback previously registered with a call to IAudioStateMonitor::RegisterCallback. |
Remarks
The method you use for instantiating the interface determines which audio streams are monitored. Factory methods are provided for monitoring capture and render streams, as well as monitoring streams based on audio category, device role, and audio device ID.
- CreateCaptureAudioStateMonitor
- CreateCaptureAudioStateMonitorForCategory
- CreateCaptureAudioStateMonitorForCategoryAndDeviceId
- CreateCaptureAudioStateMonitorForCategoryAndDeviceRole
- CreateRenderAudioStateMonitor
- CreateRenderAudioStateMonitorForCategory
- CreateRenderAudioStateMonitorForCategoryAndDeviceId
- CreateRenderAudioStateMonitorForCategoryAndDeviceRole
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows build 19043 |
| Header | audiostatemonitorapi.h |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for