MFCreateTransformActivate 함수(mftransform.h)

  • 아티클

MFT(Media Foundation 변환)에 대한 제네릭 활성화 개체를 만듭니다.

구문

HRESULT MFCreateTransformActivate(
  [out] IMFActivate **ppActivate
);

매개 변수

[out] ppActivate

IMFActivate 인터페이스에 대한 포인터를 받습니다. 호출자는 인터페이스를 해제해야 합니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

대부분의 애플리케이션은 이 함수를 사용하지 않습니다. MFTEnumEx 함수에서 내부적으로 사용됩니다.

활성화 개체는 클래스 팩터리와 유사하게 다른 개체를 만드는 도우미 개체입니다. MFCreateTransformActivate 함수는 MFT에 대한 활성화 개체를 만듭니다. 이 활성화 개체가 MFT를 만들려면 먼저 호출자가 하나 이상의 특성을 설정하여 활성화 개체를 초기화해야 합니다.

attribute Description
MFT_TRANSFORM_CLSID_Attribute 필수 요소. MFT의 CLSID를 포함합니다. 활성화 개체는 이 CLSID를 CoCreateInstance 함수에 전달하여 MFT를 만듭니다.
MF_TRANSFORM_CATEGORY_Attribute (선택 사항) MFT의 범주를 지정합니다.
MF_TRANSFORM_FLAGS_Attribute MFT를 설명하는 다양한 플래그를 포함합니다. 하드웨어 기반 MFT의 경우 MFT_ENUM_FLAG_HARDWARE 플래그를 설정합니다. 그렇지 않으면 이 특성은 선택 사항입니다.
MFT_CODEC_MERIT_Attribute (선택 사항) 하드웨어 코덱의 장점 값을 포함합니다.

이 특성이 설정되고 해당 값이 0보다 큰 경우 활성화 개체는 MFGetMFTMerit 을 호출하여 MFT에 대한 신뢰할 수 있는 장점 값을 가져옵니다. 신뢰할 수 있는 장점이 이 특성 값보다 작으면 활성화 개체의 IMFActivate::ActivateObject 메서드가 실패하고 MF_E_INVALID_CODEC_MERIT 반환합니다.
MFT_ENUM_HARDWARE_URL_Attribute 하드웨어 기반 MFT에 필요합니다. 하드웨어 디바이스에 대한 기호 링크를 지정합니다. 디바이스 프록시는 이 값을 사용하여 MFT를 구성합니다.
MFT_FIELDOFUSE_UNLOCK_Attribute (선택 사항) MFT의 잠금을 해제하는 데 사용할 수 있는 IMFFieldOfUseMFTUnlock 포인터를 포함합니다. IMFFieldOfUseMFTUnlock 인터페이스는 사용 제한이 있는 MFT와 함께 사용됩니다.

이 특성이 설정되고 MF_TRANSFORM_FLAGS_Attribute 특성에 MFT_ENUM_FLAG_FIELDOFUSE 플래그가 포함된 경우 활성화 개체는 MFT를 만들 때 IMFFieldOfUseMFTUnlock::Unlock 를 호출합니다. 애플리케이션은 MFT_ENUM_FLAG_FIELDOFUSE 플래그를 설정하지 않고 도 MFT_FIELDOFUSE_UNLOCK_Attribute 특성을 설정할 수 있습니다. 이 경우 애플리케이션은 Unlock를 호출해야 합니다.
MFT_PREFERRED_ENCODER_PROFILE (선택 사항) 인코더에 대한 인코딩 프로필을 포함합니다. 이 특성의 값은 IMFAttributes 포인터입니다.

이 특성이 설정되고 MF_TRANSFORM_CATEGORY_Attribute 특성 값이 MFT_CATEGORY_AUDIO_ENCODER 또는 MFT_CATEGORY_VIDEO_ENCODER 경우 활성화 개체는 인코딩 프로필을 사용하여 MFT를 구성합니다. MFT는 이 목적을 위해 ICodecAPI 또는 IPropertyStore 를 노출해야 합니다.
MFT_PREFERRED_OUTPUTTYPE_Attribute (선택 사항) 인코더의 기본 출력 형식을 지정합니다.

이 특성이 설정되고 MF_TRANSFORM_CATEGORY_Attribute 특성 값이 MFT_CATEGORY_AUDIO_ENCODER 또는 MFT_CATEGORY_VIDEO_ENCODER 경우 활성화 개체는 MFT에서 이 미디어 형식을 설정합니다.
 

활성화 개체에 대한 자세한 내용은 활성화 개체를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mftransform.h
라이브러리 Mfplat.lib
DLL Mfplat.dll

참고 항목

활성화 개체

미디어 파운데이션 함수

Media Foundation 변환