Export (0) Print
Expand All

IWICBitmapFrameDecode::GetMetadataQueryReader method

Retrieves a metadata query reader for the frame.

Syntax


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

Parameters

ppIMetadataQueryReader [out]

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

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

Wincodec.h

IDL

Wincodec.idl

Library

Windowscodecs.lib

DLL

Windowscodecs.dll

See also

IWICBitmapFrameDecode
Conceptual
WIC Metadata Overview
Metadata Query Language Overview
Overview of Reading and Writing Image Metadata

 

 

Community Additions

ADD
Show:
© 2014 Microsoft