CreateCaptureAudioStateMonitorForCategoryAndDeviceRole
Creates a new instance of IAudioStateMonitor that monitors the audio level for all audio capture streams in the specified category and with the specified role.Syntax
Parameters
categoryType: AUDIO_STREAM_CATEGORY A member of the AUDIO_STREAM_CATEGORY enumeration that specifies the category of the audio capture streams to be monitored. role
Type: ERole A member of the ERole enumeration that specifies the role of the audio capture streams to be monitored. audioStateMonitor _Out_
Type: IAudioStateMonitor** This output parameter is populated with the created
IAudioStateMonitor object.
Return value
If the method succeeds, it returnsS\_OK.
Remarks
This is one of the functions that create and return anAudioStateMonitor instance.
There are four variants each for capture and render streams that determine whether a process can do one of the following for a given role:
- Capture or render any audio of any category
- Capture or render audio of a specific category
- Capture or render audio of a specific category, to a specific endpoint.
The endpoint may be specified using theMMDeviceID (obtained usingIMMDevice::GetId()), or by using itsSWDID (obtained usingWindows.Devices.EnumerationorWindows.Media.Devices.MediaDevice) - Capture or render audio of a specific category to the default endpoint
IAudioStateMonitor object for this scenario.
