IWICImagingFactory::CreateFastMetadataEncoderFromFrameDecode 메서드(wincodec.h)

아티클
03/03/2024

지정된 이미지 프레임을 기반으로 빠른 메타데이터 인코더의 새 instance 만듭니다.

구문

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
라이브러리	Windowscodecs.lib
DLL	Windowscodecs.dll