CreateCaptureAudioStateMonitorForCategoryAndDeviceId
[Some information relates to pre-released product which may be substantially modified before it’s commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.] Creates a new instance of IAudioStateMonitor that monitors the audio level of all audio capture streams in the specified category for the audio endpoint with the specifieddevice ID.
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. deviceId
Type: PCWSTR A device ID specifying the audio endpoint for which audio capture streams are monitored. audioStateMonitor _Out_
Type: IAudioStateMonitor** This output parameter is populated with the created
IAudioStateMonitor object.
Return value
Type: HRESULT 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