Edit

Share via

IAudioSystemEffects3 interface (audioengineextensionapo.h)

  • Article

Implementing this interface also implies that the APO supports the APO Settings framework and allows the APO to subscribe for common audio related notifications from the Audio Engine

This interface is also implemented by clients that require an APOInitSystemEffects3 structure to be passed into the IAudioProcessingObject::Initialize method. APOInitSystemEffects3 adds the ability to obtain a service provider such as IAudioProcessingObjectLoggingService or IAudioProcessingObjectRTQueueService.

Note

On OS versions earlier than Windows Build 22000, the system will not pass an APOInitSystemEffects3 into IAudioProcessingObject::Initialize even if the client implements IAudioSystemEffects3, but will instead pass an older version of the structure, APOInitSystemEffects2 or APOInitSystemEffects, into Initialize.

Inheritance

The IAudioSystemEffects3 interface inherits from the IAudioSystemEffects2 interface.

Methods

The IAudioSystemEffects3 interface has these methods.

 
IAudioSystemEffects3::GetControllableSystemEffectsList

Implemented by System Effects Audio Processing Object (sAPO) audio effects to allow the caller to get the current list of effects.
IAudioSystemEffects3::SetAudioSystemEffectState

Implemented by System Effects Audio Processing Object (sAPO) audio effects to allow the caller to set the state of effects.

Remarks

For more information on the Windows 11 APIs for the Audio Processing Objects (APOs) that can ship with audio drivers, see Windows 11 APIs for Audio Processing Objects.

Requirements

Requirement Value
Minimum supported client Windows Build 22000
Header audioengineextensionapo.h