通过

APO_NOTIFICATION 结构 (audioengineextensionapo.h)

  • 项目

表示更改 APO 终结点或系统效果的通知。

语法

typedef struct APO_NOTIFICATION {
  APO_NOTIFICATION_TYPE type;
  union {
    AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION        audioEndpointVolumeChange;
    AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION      audioEndpointPropertyChange;
    AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION audioSystemEffectsPropertyChange;
    AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2       audioEndpointVolumeChange2;
    DEVICE_ORIENTATION_TYPE                          deviceOrientation;
    AUDIO_MICROPHONE_BOOST_NOTIFICATION              audioMicrophoneBoostChange;
    AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION      audioEnvironmentChange;
  } DUMMYUNIONNAME;
} APO_NOTIFICATION;

成员

type

APO_NOTIFICATION_TYPE 枚举中的值，指定通知所表示的更改类型。

DUMMYUNIONNAME

DUMMYUNIONNAME.audioEndpointVolumeChange

当 type 为APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME时，联合值为表示 APO 终结点卷更改通知 的AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION 。

DUMMYUNIONNAME.audioEndpointPropertyChange

当 类型 为APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE时，联合值是表示 APO 终结点属性更改通知 的AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION 。

DUMMYUNIONNAME.audioSystemEffectsPropertyChange

当 type 为APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE时，联合值是表示 APO 系统效果属性更改通知 的AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION 。

DUMMYUNIONNAME.audioEndpointVolumeChange2

当 type 为APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2时，联合值是一个 AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 表示 APO 终结点卷（包括主卷和通道卷）的更改通知（以 dB 为单位）。

DUMMYUNIONNAME.deviceOrientation

APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION 类型 时，联合值是表示设备方向值的 DEVICE_ORIENTATION_TYPE 。

DUMMYUNIONNAME.audioMicrophoneBoostChange

当 type 为APO_NOTIFICATION_TYPE_MICROPHONE_BOOST时，联合值是表示终结点麦克风提升 APO 通知 的AUDIO_MICROPHONE_BOOST_NOTIFICATION 。

DUMMYUNIONNAME.audioEnvironmentChange

APO_NOTIFICATION_TYPE_AUDIO_ENVIRONMENT_STATE_CHANGE 类型 时，联合值为表示音频环境更改 APO 通知 的AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION 。

注解

通过实现 IAudioProcessingObjectNotifications：：GetApoNotificationRegistrationInfo 注册要接收的通知类型。 通过实现 IAudioProcessingObjectNotifications：：HandleNotification 接收已注册的通知。

有关音频处理对象Windows 11 API (音频驱动程序附带的 API) 的详细信息，请参阅音频处理对象的 Windows 11 API。

要求

要求 值
最低受支持的客户端 Windows 内部版本 22000
标头 audioengineextensionapo.h