IWICMetadataBlockWriter interface (wincodecsdk.h)
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
Other Resources