Share via

Interface IWICFastMetadataEncoder (wincodec.h)

  • Artigo

Expõe métodos usados para edição de metadados in-loco. Um codificador de metadados rápido permite adicionar e remover metadados a uma imagem sem precisar recodificar totalmente a imagem.

Herança

A interface IWICFastMetadataEncoder herda da interface IUnknown . IWICFastMetadataEncoder também tem estes tipos de membros:

Métodos

A interface IWICFastMetadataEncoder tem esses métodos.

 
IWICFastMetadataEncoder::Commit

Finaliza as alterações de metadados no fluxo de imagem.
IWICFastMetadataEncoder::GetMetadataQueryWriter

Recupera um gravador de consulta de metadados para codificação rápida de metadados.

Comentários

Um decodificador deve ser criado usando o valor WICDecodeOptionsWICDecodeMetadataCacheOnDemand para executar atualizações de metadados in-loco. Usar a opção WICDecodeMetadataCacheOnLoad faz com que o decodificador libere o fluxo de arquivos necessário para executar as atualizações de metadados.

Nem todos os formatos de metadados dão suporte à codificação rápida de metadados. Os manipuladores de metadados nativos que dão suporte a metadados são IFD, Exif, XMP e GPS.

Se um codificador de metadados rápido falhar, a imagem precisará ser totalmente recodificada para adicionar os metadados.

Exemplos

A seguir, demonstra como obter um codificador de metadados rápido de um quadro de imagem e usar seu gravador de consulta para gravar um item de metadados.

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 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