Edit

Share via

ISpatialAudioMetadataCopier interface (spatialaudiometadata.h)

  • Article

Provides methods for copying all or subsets of metadata items from a source SpatialAudioMetadataItems into a destination SpatialAudioMetadataItems. The SpatialAudioMetadataItems object, which is populated using an ISpatialAudioMetadataWriter or ISpatialAudioMetadataCopier, has a frame count, specified with the frameCount parameter to ActivateSpatialAudioMetadataItems, that represents the valid range of metadata item offsets. ISpatialAudioMetadataReader enables copying groups of items within a subrange of the total frame count. The object maintains an internal read position, which is advanced by the number of frames specified when a copy operation is performed.

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 ISpatialAudioMetadataCopier interface inherits from the IUnknown interface. ISpatialAudioMetadataCopier also has these types of members:

Methods

The ISpatialAudioMetadataCopier interface has these methods.

 
ISpatialAudioMetadataCopier::Close

Completes any necessary operations on the SpatialAudioMetadataItems object and releases the object. (ISpatialAudioMetadataCopier.Close)
ISpatialAudioMetadataCopier::CopyMetadataForFrames

Copies metadata items from the source ISpatialAudioMetadataItems, provided to the Open method, object to the destination ISpatialAudioMetadataItems object, specified with the dstMetadataItems parameter.
ISpatialAudioMetadataCopier::Open

Opens an ISpatialAudioMetadataItems object for copying.

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 spatialaudiometadata.h