APOInitSystemEffects3 structure (audioengineextensionapo.h)

Provides audio processing object (APO) initialization parameters, extending APOInitSystemEffects2 to add the ability to specify a service provider for logging.

Syntax

typedef struct APOInitSystemEffects3 {
  APOInitBaseStruct   APOInit;
  IPropertyStore      *pAPOEndpointProperties;
  IServiceProvider    *pServiceProvider;
  IMMDeviceCollection *pDeviceCollection;
  UINT                nSoftwareIoDeviceInCollection;
  UINT                nSoftwareIoConnectorIndex;
  GUID                AudioProcessingMode;
  BOOL                InitializeForDiscoveryOnly;
} APOInitSystemEffects3;

Members

APOInit

An APOInitBaseStruct structure.

pAPOEndpointProperties

A pointer to an IPropertyStore object.

pServiceProvider

An IServiceProvider interface.

pDeviceCollection

A pointer to an IMMDeviceCollection object. The last item in the pDeviceCollection is always the IMMDevice representing the audio endpoint.

nSoftwareIoDeviceInCollection

Specifies the MMDevice that implements the DeviceTopology that includes the software connector for which the APO is initializing. The MMDevice is contained in pDeviceCollection.

nSoftwareIoConnectorIndex

Specifies the index of a Software_IO connector in the DeviceTopology.

AudioProcessingMode

Specifies the processing mode for the audio graph.

InitializeForDiscoveryOnly

Indicates whether the audio system is initializing the APO for effects discovery only.

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
Minimum supported server Windows Build 22000
Header audioengineextensionapo.h

See also

APOInitSystemEffects APOInitSystemEffects2