Método IWICImagingFactory::CreateFastMetadataEncoderFromFrameDecode (wincodec.h)

Artigo
03/03/2024

Cria uma nova instância do codificador de metadados rápido com base no quadro de imagem especificado.

Sintaxe

HRESULT CreateFastMetadataEncoderFromFrameDecode(
  [in]  IWICBitmapFrameDecode   *pIFrameDecoder,
  [out] IWICFastMetadataEncoder **ppIFastEncoder
);

Parâmetros

[in] pIFrameDecoder

Tipo: IWICBitmapFrameDecode*

O IWICBitmapFrameDecode do qual criar o IWICFastMetadataEncoder .

[out] ppIFastEncoder

Tipo: IWICFastMetadataEncoder**

Quando esse método retorna, contém um ponteiro para um novo codificador de metadados rápido.

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 obter uma lista de formatos de metadados de suporte para codificação rápida de metadados, consulte Visão geral de metadados wic.

Exemplos

O código a seguir demonstra como usar o método CreateFastMetadataEncoderFromFrameDecode para codificação rápida 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

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