Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

IWICBitmapFrameDecode::GetMetadataQueryReader method (wincodec.h)

Retrieves a metadata query reader for the frame.

Syntax

HRESULT GetMetadataQueryReader(
 [out] IWICMetadataQueryReader **ppIMetadataQueryReader
);

Parameters

[out] ppIMetadataQueryReader

Type: IWICMetadataQueryReader**

When this method returns, contains a pointer to the frame's metadata query reader.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

For image formats with one frame (JPG, PNG, JPEG-XR), the frame-level query reader of the first frame is used to access all image metadata, and the decoder-level query reader isn’t used. For formats with more than one frame (GIF, TIFF), the frame-level query reader for a given frame is used to access metadata specific to that frame, and in the case of GIF a decoder-level metadata reader will be present. If the decoder doesn’t support metadata (BMP, ICO), this will return WINCODEC_ERR_UNSUPPORTEDOPERATION.

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 wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll

See also

Conceptual

IWICBitmapFrameDecode

Metadata Query Language Overview

Overview of Reading and Writing Image Metadata

WIC Metadata Overview


Feedback

Was this page helpful?

Additional resources