ISpatialAudioMetadataCopier::CopyMetadataForFrames method (spatialaudiometadata.h)
Copies metadata items from the source ISpatialAudioMetadataItems, provided to the Open method, object to the destination ISpatialAudioMetadataItems object, specified with the dstMetadataItems parameter. Each call advances the internal copy position by the number of frames in the copyFrameCount parameter.
Syntax
HRESULT CopyMetadataForFrames(
[in] UINT16 copyFrameCount,
[in] SpatialAudioMetadataCopyMode copyMode,
[in] ISpatialAudioMetadataItems *dstMetadataItems,
[out] UINT16 *itemsCopied
);
Parameters
[in] copyFrameCount
The number of frames from the current copy position for which metadata items are copied. After the copy, the internal copy position within the source SpatialAudioMetadataItems is advanced the value specified in this parameter. Set this value to 0 to copy the entire frame range contained in the source SpatialAudioMetadataItems.
[in] copyMode
A value that specifies the copy mode for the operation.
[in] dstMetadataItems
A pointer to the destination SpatialAudioMetadataItems for the copy operation.
[out] itemsCopied
Receives number of metadata items copied in the operation.
Return value
If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.
Return code | Description |
---|---|
|
The ISpatialAudioMetadataItems has not been opened for copying with a call to Open or the object has been closed for writing with a call to Close. |
|
One of the provided pointers is not valid. |
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | spatialaudiometadata.h |