IWICImagingFactory：：CreateFastMetadataEncoderFromFrameDecode 方法 (wincodec.h)

项目
03/13/2024

基于给定的图像帧创建快速元数据编码器的新实例。

语法

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

参数

[in] pIFrameDecoder

类型： IWICBitmapFrameDecode*

要从中创建 IWICFastMetadataEncoder 的 IWICBitmapFrameDecode。

[out] ppIFastEncoder

类型： IWICFastMetadataEncoder**

此方法返回时，包含指向新的快速元数据编码器的指针。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

注解

有关支持快速元数据编码的元数据格式的列表，请参阅 WIC 元数据概述。

示例

以下代码演示如何使用 CreateFastMetadataEncoderFromFrameDecode 方法进行快速元数据编码。

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();
}

要求

要求	值
最低受支持的客户端	Windows XP SP2、Windows Vista [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	wincodec.h
Library	Windowscodecs.lib
DLL	Windowscodecs.dll