MFTRegisterLocal 함수(mfapi.h)

호출자 프로세스에 MFT(Media Foundation 변환)를 등록합니다.

구문

HRESULT MFTRegisterLocal(
  [in] IClassFactory                *pClassFactory,
  [in] REFGUID                      guidCategory,
  [in] LPCWSTR                      pszName,
  [in] UINT32                       Flags,
  [in] UINT32                       cInputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pInputTypes,
  [in] UINT32                       cOutputTypes,
  [in] const MFT_REGISTER_TYPE_INFO *pOutputTypes
);

매개 변수

[in] pClassFactory

클래스 팩터리 개체의 IClassFactory 인터페이스에 대한 포인터입니다. 클래스 팩터리는 MFT를 만듭니다.

[in] guidCategory

MFT의 범주를 지정하는 GUID입니다. MFT 범주 목록은 MFT_CATEGORY 참조하세요.

[in] pszName

MFT의 식별 이름을 포함하는 와이드 문자 null로 끝나는 문자열입니다.

[in] Flags

_MFT_ENUM_FLAG 열거형에서 0개 이상의 플래그가 있는 비트 OR입니다.

[in] cInputTypes

pInputTypes 배열의 요소 수입니다.

[in] pInputTypes

MFT_REGISTER_TYPE_INFO 구조체 배열에 대한 포인터입니다. 배열의 각 멤버는 MFT에서 지원하는 입력 형식을 지정합니다. cInputTypes가 0인 경우 이 매개 변수는 NULL일 수 있습니다.

[in] cOutputTypes

pOutputTypes 배열의 요소 수입니다.

[in] pOutputTypes

MFT_REGISTER_TYPE_INFO 구조체 배열에 대한 포인터입니다. 배열의 각 멤버는 MFT에서 지원하는 출력 형식을 정의합니다. cOutputTypes가 0인 경우 이 매개 변수는 NULL일 수 있습니다.

반환 값

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

설명

이 함수의 주요 목적은 MFT를 다른 프로세스 또는 애플리케이션에서 사용할 수 있도록 하지 않고도 MFT를 자동 토폴로지 확인에 사용할 수 있도록 하는 것입니다.

이 함수를 호출한 후 MFTEnumEx 함수를 호출하여 MFT_ENUM_FLAG_LOCALMFT 플래그를 사용하여 MFT를 열거할 수 있습니다. MFT는 동일한 프로세스 내에서 열거할 수 있지만 다른 프로세스에는 표시되지 않습니다.

pClassFactory 매개 변수는 MFT를 만드는 클래스 팩터리 개체를 지정합니다. 클래스 팩터리의 IClassFactory::CreateInstance 메서드는 IMFTransform 인터페이스를 지원하는 개체를 반환해야 합니다.

PMP(보호된 미디어 경로) 프로세스에서 MFT를 등록해야 하는 경우 IMFLocalMFTRegistration 인터페이스를 사용합니다.

요구 사항

추가 정보

MFTRegisterLocalByCLSID

미디어 파운데이션 함수