IWICMetadataBlockReader interface

Exposes methods that provide access to all of the codec's top level metadata blocks.

Members

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

Methods

The IWICMetadataBlockReader interface has these methods.

MethodDescription
GetContainerFormat

Retrieves the container format of the decoder.

GetCount

Retrieves the number of top level metadata blocks.

GetEnumerator

Retrieves an enumeration of each of the top level metadata blocks.

GetReaderByIndex

Retrieves an IWICMetadataReader for a specified top level metadata block, providing access to the embedded metadata blocks.

 

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

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
Wincodecsdk.h

IDL
Wincodecsdk.idl

Library
Windowscodecs.lib

DLL
Windowscodecs.dll

See also

Conceptual
WIC Metadata Overview
Overview of Reading and Writing Image Metadata
Metadata Extensibility Overview

 

 

Show: