ISpatialAudioObjectForHrtf interface (spatialaudiohrtf.h)

Represents an object that provides audio data to be rendered from a position in 3D space, relative to the user, a head-relative transfer function (HRTF). Spatial audio objects can be static or dynamic, which you specify with the type parameter to the ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf method. Dynamic audio objects can be placed in an arbitrary position in space and can be moved over time. Static audio objects are assigned to one or more channels, defined in the AudioObjectType enumeration, that each correlate to a fixed speaker location that may be a physical or a virtualized speaker

This interface is a part of Windows Sonic, Microsoft’s audio platform for more immersive audio which includes integrated spatial sound on Xbox and Windows.

Inheritance

The ISpatialAudioObjectForHrtf interface inherits from ISpatialAudioObjectBase. ISpatialAudioObjectForHrtf also has these types of members:

Methods

The ISpatialAudioObjectForHrtf interface has these methods.

ISpatialAudioObjectForHrtf::SetDirectivity Sets the spatial audio directivity model for the ISpatialAudioObjectForHrtf.
ISpatialAudioObjectForHrtf::SetDistanceDecay Sets the decay model that is applied over distance from the position of an ISpatialAudioObjectForHrtf to the position of the listener.
ISpatialAudioObjectForHrtf::SetEnvironment Sets the type of acoustic environment that is simulated when audio is processed for the ISpatialAudioObjectForHrtf.
ISpatialAudioObjectForHrtf::SetGain Sets the gain for the ISpatialAudioObjectForHrtf.
ISpatialAudioObjectForHrtf::SetOrientation Sets the orientation in 3D space, relative to the listener's frame of reference, from which the ISpatialAudioObjectForHrtf audio data will be rendered.
ISpatialAudioObjectForHrtf::SetPosition Sets the position in 3D space, relative to the listener, from which the ISpatialAudioObjectForHrtf audio data will be rendered.

Remarks

Note  Many of the methods provided by this interface are implemented in the inherited ISpatialAudioObjectBase interface.

 

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1703 [desktop apps only]
Minimum supported server	Windows Server 2016 [desktop apps only]
Target Platform	Windows
Header	spatialaudiohrtf.h

See also

ISpatialAudioObjectBase