Edit

APO_NOTIFICATION_TYPE enumeration (audioengineextensionapo.h)

  • Article

Specifies the type of an APO_NOTIFICATION.

Syntax

typedef enum APO_NOTIFICATION_TYPE {
  APO_NOTIFICATION_TYPE_NONE = 0,
  APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME = 1,
  APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE = 2,
  APO_NOTIFICATION_TYPE_SYSTEM_EFFECTS_PROPERTY_CHANGE = 3,
  APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2 = 4,
  APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION = 5,
  APO_NOTIFICATION_TYPE_MICROPHONE_BOOST = 6,
  APO_NOTIFICATION_TYPE_AUDIO_ENVIRONMENT_STATE_CHANGE
} ;

Constants

 
APO_NOTIFICATION_TYPE_NONE
Value: 0
None.
APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME
Value: 1
Endpoint volume notification. The AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION structure conveys data for this notification.
APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE
Value: 2
Endpoint property change notification. The AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION structure conveys data for this notification.
APO_NOTIFICATION_TYPE_SYSTEM_EFFECTS_PROPERTY_CHANGE
Value: 3
System effects property change notification. The AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION structure conveys data for this notification.
APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2
Value: 4
Endpoint volume notification for an endpoint that includes master and channel volume, in dB. The AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 structure conveys data for this notification.
APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION
Value: 5
Display orientation notification for the device. The DEVICE_ORIENTATION_TYPE enumeration conveys data for this notification.
APO_NOTIFICATION_TYPE_MICROPHONE_BOOST
Value: 6
Microphone boost notification. The AUDIO_MICROPHONE_BOOST_NOTIFICATION structure conveys data for this notification.
APO_NOTIFICATION_TYPE_AUDIO_ENVIRONMENT_STATE_CHANGE
An audio environment state change notification. The AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION structure conveys data for this notification.

Remarks

Clients use this enumeration to specify requested notification types in their implementations of IAudioProcessingObjectNotifications2::GetApoNotificationRegistrationInfo2 and IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo.

The APO_NOTIFICATION structure passed into HandleNotification will contain a different structure in its union field depending on which type of notification is being raised. For more information, see APO_NOTIFICATION Structure.

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
Minimum supported client Windows Build 22000
Header audioengineextensionapo.h