MFTRegisterLocalByCLSID 함수(mfapi.h)

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

구문

HRESULT MFTRegisterLocalByCLSID(
  [in] REFCLSID                     clisdMFT,
  [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] clisdMFT

MFT의 CLSID(클래스 식별자)입니다.

[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는 동일한 프로세스 내에서 열거할 수 있지만 다른 프로세스에는 표시되지 않습니다.

현재 프로세스에서 MFT를 등록 취소하려면 MFTUnregisterLocalByCLSID를 호출합니다.

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

요구 사항

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

추가 정보

MFTRegisterLocal

미디어 파운데이션 함수