Interfaz IWICFastMetadataEncoder (wincodec.h)

  • Artículo

Expone métodos usados para la edición de metadatos en contexto. Un codificador de metadatos rápido le permite agregar y quitar metadatos a una imagen sin tener que volver a codificar completamente la imagen.

Herencia

La interfaz IWICFastMetadataEncoder hereda de la interfaz IUnknown . IWICFastMetadataEncoder también tiene estos tipos de miembros:

Métodos

La interfaz IWICFastMetadataEncoder tiene estos métodos.

 
IWICFastMetadataEncoder::Commit

Finaliza los cambios de metadatos en la secuencia de imágenes.
IWICFastMetadataEncoder::GetMetadataQueryWriter

Recupera un escritor de consultas de metadatos para codificar metadatos rápidos.

Comentarios

Se debe crear un descodificador con el valor WICDecodeOptionsWICDecodeMetadataCacheOnDemand para realizar actualizaciones de metadatos en contexto. El uso de la opción WICDecodeMetadataCacheOnLoad hace que el descodificador libere la secuencia de archivos necesaria para realizar las actualizaciones de metadatos.

No todos los formatos de metadatos admiten codificación rápida de metadatos. Los controladores de metadatos nativos que admiten metadatos son IFD, Exif, XMP y GPS.

Si se produce un error en un codificador de metadatos rápido, la imagen deberá volver a codificarse completamente para agregar los metadatos.

Ejemplos

A continuación se muestra cómo obtener un codificador de metadatos rápido de un marco de imagen y usar su escritor de consultas para escribir un elemento de metadatos.

IWICFastMetadataEncoder *pFME = NULL;
IWICMetadataQueryWriter *pFMEQW = NULL;

hr = pFactory->CreateFastMetadataEncoderFromFrameDecode(pFrameDecode, &pFME);

if (SUCCEEDED(hr))
{
 	hr = pFME->GetMetadataQueryWriter(&pFMEQW);
}

if (SUCCEEDED(hr))
{
	 // Add additional metadata
 	PROPVARIANT value;

	 PropVariantInit(&value);

 	value.vt = VT_UI2;
	 value.uiVal = 99;
 	hr = pFMEQW->SetMetadataByName(L"/app1/ifd/{ushort=18249}", &value);

 	PropVariantClear(&value);
}

if (SUCCEEDED(hr))
{
	 hr = pFME->Commit();
}

Requisitos

   
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