IWICMetadataBlockWriter interface
Exposes methods that enable the encoding of metadata. This interface is implemented by the decoder and its image frames.
Members
The IWICMetadataBlockWriter interface inherits from IWICMetadataBlockReader. IWICMetadataBlockWriter also has these types of members:
Methods
The IWICMetadataBlockWriter interface has these methods.
| Method | Description |
|---|---|
| AddWriter |
Adds a top-level metadata block by adding a IWICMetadataWriter for it. |
| GetWriterByIndex |
Retrieves the IWICMetadataWriter that resides at the specified index. |
| InitializeFromBlockReader |
Initializes an IWICMetadataBlockWriter from the given IWICMetadataBlockReader. This will prepopulate the metadata block writer with all the metadata in the metadata block reader. |
| RemoveWriterByIndex |
Removes the metadata writer from the specified index location. |
| 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
|
Minimum supported client |
Windows XP with SP2, Windows Vista [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps | Windows Store apps] |
|
Header |
|
|
IDL |
|
|
Library |
|
|
DLL |
|
See also
- IWICMetadataBlockReader
- Conceptual
- WIC Metadata Overview
- Overview of Reading and Writing Image Metadata
- How-to: Re-encode a JPEG Image with Metadata
- Other Resources
- How to Write a WIC-Enabled CODEC