Метод IAudioProcessingObjectNotifications::HandleNotification (audioengineextensionapo.h)

Статья
03/16/2023

Вызывается системой для уведомления клиентов об изменениях конечных точек APO или системных эффектов.

Синтаксис

void HandleNotification(
  APO_NOTIFICATION *apoNotification
);

Параметры

apoNotification

APO_NOTIFICATION, представляющее изменение APO, связанное с уведомлением.

Возвращаемое значение

None

Remarks

Укажите набор изменений APO, для которых вызывается этот метод, реализуя IAudioProcessingObjectNotifications::GetApoNotificationRegistrationInfo.

Этот метод будет вызываться после вызова LockForProcess и перестанет вызываться до UnlockForProcess. Если в процессе выполнения есть какие-либо уведомления, они могут быть выполнены во время или после UnlockForProcess. В этом случае APO должен обрабатывать синхронизацию.

Примечание

ApOs должны запрашивать каждое свойство один раз, чтобы получить его начальное значение, так как метод HandleNotification вызывается только при изменении любого из свойств. Исключениями из этого являются начальный громкость конечной точки звука, когда APO регистрируется для APO_NOTIFICATION_TYPE_ENDPOINT_VOLUME и значение PKEY_AudioEndpoint_Disable_SysFx, если APO регистрирует для APO_NOTIFICATION_TYPE_ENDPOINT_PROPERTY_CHANGE

Дополнительные сведения об API Windows 11 для объектов обработки звука (APOs), которые могут поставляться с аудиодрайверами, см. в статье Windows 11 API для объектов обработки звука.

Требования

Требование	Значение
Минимальная версия клиента	Сборка Windows 22000
Верхняя часть	audioengineextensionapo.h

Поделиться через