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

type が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の場合、共用体の値は、マスターとチャネル ボリュームを含む APO エンドポイント ボリュームへの変更の通知を dB で表すAUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2です。

DUMMYUNIONNAME.deviceOrientation

type がAPO_NOTIFICATION_TYPE_DEVICE_ORIENTATIONの場合、共用体の値はデバイスの向きの値を表すDEVICE_ORIENTATION_TYPEです。

DUMMYUNIONNAME.audioMicrophoneBoostChange

type がAPO_NOTIFICATION_TYPE_MICROPHONE_BOOSTの場合、共用体の値はエンドポイント マイクブースト APO 通知を表すAUDIO_MICROPHONE_BOOST_NOTIFICATIONです。

DUMMYUNIONNAME.audioEnvironmentChange

type がAPO_NOTIFICATION_TYPE_AUDIO_ENVIRONMENT_STATE_CHANGEの場合、共用体の値はオーディオ環境の変更 APO 通知を表すAUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATIONです。

注釈

IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo を実装して、受信する通知の種類に登録します。 IAudioProcessingObjectNotifications::HandleNotification を実装して、登録済みの通知を受信します。

オーディオ ドライバーに付属できるオーディオ処理オブジェクト (API) のWindows 11 API の詳細については、「Windows 11 API for Audio Processing Objects」を参照してください。

要件