IAudioProcessingObjectNotifications::HandleNotification 方法 (audioengineextensionapo.h)

由系统调用,以通知客户端 APO 终结点或系统效果的更改。

语法

void HandleNotification(
  APO_NOTIFICATION *apoNotification
);

参数

apoNotification

表示与通知关联的 APO 更改 的APO_NOTIFICATION

返回值

备注

指定通过实现 IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo 为其调用此方法的 APO 更改集。

此方法将在 调用 LockForProcess 后调用,并在 UnlockForProcess 之前停止调用。 如果有任何通知处于未完成状态,它们可能会在 UnlockForProcess 期间或之后执行。 在这种情况下,APO 必须处理同步。

注意

ADO 必须查询每个属性一次才能获取其初始值,因为仅当任何属性发生更改时才会调用 HandleNotification 方法。 例外情况是 APO 注册APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME时的初始音频终结点音量,如果 APO 注册APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE值PKEY_AudioEndpoint_Disable_SysFx

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

要求

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