ISpatialAudioMetadataCopier interface (spatialaudiometadata.h)

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