IWICMetadataBlockReader interface (wincodecsdk.h)
Exposes methods that provide access to all of the codec's top level metadata blocks.
Inheritance
The IWICMetadataBlockReader interface inherits from the IUnknown interface. IWICMetadataBlockReader also has these types of members:
Methods
The IWICMetadataBlockReader interface has these methods.
| IWICMetadataBlockReader::GetContainerFormat Retrieves the container format of the decoder. |
| IWICMetadataBlockReader::GetCount Retrieves the number of top level metadata blocks. |
| IWICMetadataBlockReader::GetEnumerator Retrieves an enumeration of IWICMetadataReader objects representing each of the top level metadata blocks. |
| IWICMetadataBlockReader::GetReaderByIndex Retrieves an IWICMetadataReader for a specified top level metadata block. |
Remarks
IWICMetadataBlockReader and IWICMetadataBlockWriter operate at the root level only; that is, they provide read and write access, respectively, to the top level metadata blocks. They are implemented by IWICBitmapFrameDecode and IWICBitmapFrameEncode, respectively. To handle any metadata blocks that are not at the top level of the hierarchy, use IWICMetadataReader or IWICMetadataWriter.
Note The codec's decoder and encoder implement this interface to expose the enumeration of all top level metadata blocks. While the codec parses the image stream, it calls services like CreateMetadataReaderFromContainer to instantiate metadata readers for any block that is recognized as being able to be embedded in the decoder's container format. The collection of metadata readers is exposed through this interface. For more info, see How to Write a WIC-Enabled CODEC.
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
Metadata Extensibility Overview