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 |