Edit

IWICMetadataBlockWriter interface (wincodecsdk.h)

  • Article

Exposes methods that enable the encoding of metadata. This interface is implemented by the decoder and its image frames.

Inheritance

The IWICMetadataBlockWriter interface inherits from IWICMetadataBlockReader. IWICMetadataBlockWriter also has these types of members:

Methods

The IWICMetadataBlockWriter interface has these methods.

 
IWICMetadataBlockWriter::AddWriter

Adds a top-level metadata block by adding a IWICMetadataWriter for it.
IWICMetadataBlockWriter::GetWriterByIndex

Retrieves the IWICMetadataWriter that resides at the specified index.
IWICMetadataBlockWriter::InitializeFromBlockReader

Initializes an IWICMetadataBlockWriter from the given IWICMetadataBlockReader. This will prepopulate the metadata block writer with all the metadata in the metadata block reader.
IWICMetadataBlockWriter::RemoveWriterByIndex

Removes the metadata writer from the specified index location.
IWICMetadataBlockWriter::SetWriterByIndex

Replaces the metadata writer at the specified index location.

Remarks

When the encoder is told to commit, it goes through each metadata writer and serializes the metadata content into the encoding stream. If the metadata block contains metadata important to the integrity of the file, such as the image width or height or other intrinsic information about the image, the encoder must set the critical metadata items prior to serializing the metadata.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2, Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header wincodecsdk.h

See also

Conceptual

How to Write a WIC-Enabled CODEC

How-to: Re-encode a JPEG Image with Metadata

IWICMetadataBlockReader

Other Resources

Overview of Reading and Writing Image Metadata

WIC Metadata Overview