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

當 類型 為APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME時，等位值是代表 APO 端點磁碟區變更通知 的AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION 。

DUMMYUNIONNAME.audioEndpointPropertyChange

當 類型 為APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE時，聯集值是 AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION 代表 APO 端點屬性變更的通知。

DUMMYUNIONNAME.audioSystemEffectsPropertyChange

當 類型 為APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE時，等位值是 AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION ，代表 APO 系統效果屬性變更的通知。

DUMMYUNIONNAME.audioEndpointVolumeChange2

當 類型 為APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2時，聯集值是 AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 ，代表 dB 中對包含主要和通道磁碟區的 APO 端點磁碟區變更通知。

DUMMYUNIONNAME.deviceOrientation

當 類型 APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION時，等位值是代表裝置方向值的 DEVICE_ORIENTATION_TYPE 。

DUMMYUNIONNAME.audioMicrophoneBoostChange

當類型為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