// acxelements.h
typedef struct _ACX_AUDIOENGINE_CONFIG {
ULONG Size;
ULONG Id;
const GUID *Name;
ULONG Flags;
ACXPIN HostPin;
ACXPIN OffloadPin;
ACXPIN LoopbackPin;
ACXVOLUME VolumeElement;
ACXMUTE MuteElement;
ACXPEAKMETER PeakMeterElement;
PACX_AUDIOENGINE_CALLBACKS Callbacks;
} ACX_AUDIOENGINE_CONFIG, *PACX_AUDIOENGINE_CONFIG;
View the official Windows Driver Kit DDI referenceNo description available.
The ACX_AUDIOENGINE_CONFIG structure is used to define the audio engine configuration.
SizeThe length, in bytes, of this structure.
IdA number that represents the element ID.
NameA pointer to a GUID that represents the name of the element. Can be used for debugging and will default to GUID_NULL if not provided.
FlagsAudio engine configuration flags defined by the ACX_AUDIOENGINE_CONFIG_FLAGS enum.
No flag bits are currently defined. Set this member to zero - AcxAudioEngineConfigNoFlags
HostPinAn existing ACXPIN object that serves as the host pin for the audio engine. For more information about ACX objects, see Summary of ACX Objects.
OffloadPinAn existing ACXPIN object that represents the offload pin.
LoopbackPinAn existing ACXPIN object that represents the loopback pin.
VolumeElementAn existing ACXVOLUME object that is used for volume operations by the audio engine.
MuteElementAn existing ACXMUTE object that is used for mute operations by the audio engine.
PeakMeterElementAn existing ACXPEAKMETER object that is used for peakmeter operations by the audio engine.
CallbacksAn ACX_AUDIOENGINE_CALLBACKS structure that defines the callbacks for the audio engine.
Example usage is shown below.
ACX_AUDIOENGINE_CONFIG audioEngineCfg;
ACX_AUDIOENGINE_CALLBACKS audioEngineCallbacks;
// Initialize the config structure
ACX_AUDIOENGINE_CONFIG_INIT(&audioEngineCfg);
// Set the values of the structure
audioEngineCfg.HostPin = Pins[HostPin];
audioEngineCfg.OffloadPin = Pins[OffloadPin];
audioEngineCfg.LoopbackPin = Pins[LoopbackPin];
audioEngineCfg.VolumeElement = volumeElement;
audioEngineCfg.MuteElement = muteElement;
audioEngineCfg.PeakMeterElement = peakmeterElement;
audioEngineCfg.Callbacks = &audioEngineCallbacks;
Minimum ACX version: 1.0
For more information about ACX versions, see ACX version overview.