AUDIO_MICROPHONE_BOOST_NOTIFICATION structure (audioengineextensionapo.h)

Represents an audio microphone boost APO notification.

Syntax

typedef struct AUDIO_MICROPHONE_BOOST_NOTIFICATION {
  IMMDevice *endpoint;
  GUID      eventContext;
  BOOL      microphoneBoostEnabled;
  float     levelInDb;
  float     levelMinInDb;
  float     levelMaxInDb;
  float     levelStepInDb;
  BOOL      muteSupported;
  BOOL      mute;
} AUDIO_MICROPHONE_BOOST_NOTIFICATION;

Members

endpoint

An IMMDevice representing the audio endpoint associated with the notification.

eventContext

A GUID representing the context associated with the originator of the event. A client can use this method to keep track of control changes made by other processes and by the hardware. The functions IAudioVolumeLevel::SetLevel and IAudioMute::SetMute use the context. When this notification is recieved, a client can inspect the context GUID to discover whether it or another client is the source of the notification.

microphoneBoostEnabled

A boolean value indicating the presence of a "Microphone Boost" part (connector or subunit) of an audio capture device topology.

levelInDb

A float value specifying the volume level in decibels.

levelMinInDb

A float value specifying the minimum volume level in decibels.

levelMaxInDb

A float value specifying the maximum volume level in decibels.

levelStepInDb

A float value specifying the stepping value between consecutive volume levels in the range levelMinInDb to levelMaxInDb.

muteSupported

A boolean value indicating if the IAudioMute interface is supported by the "Microphone Boost" part of the audio capture device topology.

mute

A boolean value indicating the current state (enabled or disabled) of the mute control

Remarks

For more information on the Windows 11 APIs for the Audio Processing Objects (APOs) that can ship with audio drivers, see Windows 11 APIs for Audio Processing Objects.

Requirements

Requirement	Value
Header	audioengineextensionapo.h