다음을 통해 공유

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 경우 공용 구조체 값은 APO 엔드포인트 속성 변경 알림을 나타내는 AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION.

DUMMYUNIONNAME.audioSystemEffectsPropertyChange

형식이 APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE 경우 공용 구조체 값은 APO 시스템 효과 속성 변경 알림을 나타내는 AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION.

DUMMYUNIONNAME.audioEndpointVolumeChange2

형식이 APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME2 경우 공용 구조체 값은 DB에서 master 및 채널 볼륨을 포함하는 APO 엔드포인트 볼륨에 대한 변경 알림을 나타내는 AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2.

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을 구현하여 등록된 알림을 받습니다.

오디오 드라이버와 함께 제공 될 수 있는 API (오디오 처리 개체)에 대 한 Windows 11 API에 대 한 자세한 내용은 참조 Windows 11 오디오 처리 개체에 대 한 API입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 빌드 22000
머리글 audioengineextensionapo.h