Método IWICBitmapFrameDecode::GetMetadataQueryReader (wincodec.h)

Artigo
08/27/2023

Recupera um leitor de consulta de metadados para o quadro.

Sintaxe

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

Parâmetros

[out] ppIMetadataQueryReader

Tipo: IWICMetadataQueryReader**

Quando esse método retorna, contém um ponteiro para o leitor de consulta de metadados do quadro.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para formatos de imagem com um quadro (JPG, PNG, JPEG-XR), o leitor de consulta no nível do quadro do primeiro quadro é usado para acessar todos os metadados de imagem e o leitor de consulta no nível do decodificador não é usado. Para formatos com mais de um quadro (GIF, TIFF), o leitor de consulta no nível do quadro de um determinado quadro é usado para acessar metadados específicos a esse quadro e, no caso do GIF, um leitor de metadados no nível do decodificador estará presente. Se o decodificador não der suporte a metadados (BMP, ICO), isso retornará WINCODEC_ERR_UNSUPPORTEDOPERATION.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP com SP2, Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib
DLL	Windowscodecs.dll