Interfaz IWICMetadataQueryReader (wincodec.h)
Expone métodos para recuperar bloques de metadatos y elementos de un descodificador o sus marcos de imagen mediante una expresión de consulta de metadatos.
Herencia
La interfaz IWICMetadataQueryReader hereda de la interfaz IUnknown . IWICMetadataQueryReader también tiene estos tipos de miembros:
Métodos
La interfaz IWICMetadataQueryReader tiene estos métodos.
| IWICMetadataQueryReader::GetContainerFormat Obtiene el formato de contenedor de lectores de consultas de metadatos. |
| IWICMetadataQueryReader::GetEnumerator Obtiene un enumerador de todos los elementos de metadatos en la ubicación relativa actual dentro de la jerarquía de metadatos. |
| IWICMetadataQueryReader::GetLocation Recupera la ruta de acceso actual relativa al bloque de metadatos raíz. |
| IWICMetadataQueryReader::GetMetadataByName Recupera el bloque de metadatos o el elemento identificado por una expresión de consulta de metadatos. |
Comentarios
Un lector de consultas de metadatos usa expresiones de consulta de metadatos para acceder a los metadatos incrustados. Para obtener más información sobre el lenguaje de consulta de metadatos, consulte Información general sobre el lenguaje de consulta de metadatos.
La ventaja del lector de consultas es la capacidad de acceder a un elemento de metadatos en un solo paso.
El lector de consultas también proporciona la manera de recorrer todo el conjunto de jerarquías de metadatos con la ayuda del método GetEnumerator . Sin embargo, no se recomienda usar este método, ya que IWICMetadataBlockReader e IWICMetadataReader proporcionan una manera más cómoda y económica.
Ejemplos
En el código siguiente se muestra cómo obtener un lector de consultas y usarlo para recuperar un elemento de metadatos.
// Get the query reader
if (SUCCEEDED(hr))
{
hr = pFrameDecode->GetMetadataQueryReader(&pQueryReader);
}
if (SUCCEEDED(hr))
{
hr = pQueryReader->GetMetadataByName(L"/app1/ifd/{ushort=18249}", &value);
PropVariantClear(&value);
}
En el código siguiente se muestra cómo obtener el lector de consultas y usarlo para recuperar un bloque de metadatos anidado.
// Get the query reader
if (SUCCEEDED(hr))
{
hr = pFrameDecode->GetMetadataQueryReader(&pQueryReader);
}
if (SUCCEEDED(hr))
{
// Get the embedded IFD reader
hr = pQueryReader->GetMetadataByName(L"/app1/ifd", &value);
if (value.vt == VT_UNKNOWN)
{
hr = value.punkVal->QueryInterface(IID_IWICMetadataQueryReader, (void **)&pEmbedReader);
}
PropVariantClear(&value); // Clear value for new query
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | wincodec.h |
Consulte también
Conceptual
Introducción al lenguaje de consulta de metadatos
Información general sobre la lectura y escritura de metadatos de imagen