다음을 통해 공유

IMFPluginControl 인터페이스(mfobjects.h)

  • 아티클

Microsoft Media Foundation에서 미디어 원본 및 변환을 열거하는 방법을 제어합니다.

이 인터페이스에 대한 포인터를 얻으려면 MFGetPluginControl을 호출합니다.

상속

IMFPluginControl 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IMFPluginControl 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IMFPluginControl 인터페이스에는 이러한 메서드가 있습니다.

 
IMFPluginControl::GetDisabledByIndex

IMFPluginControl::GetDisabledByIndex(mfobjects.h)는 차단된 목록에서 CLSID(클래스 식별자)를 가져옵니다.
IMFPluginControl::GetPreferredClsid

기본 설정 목록에서 지정된 키 이름과 일치하는 CLSID(클래스 식별자)를 검색합니다.
IMFPluginControl::GetPreferredClsidByIndex

IMFPluginControl::GetPreferredClsidByIndex(mfobjects.h) 메서드는 인덱스 값으로 지정된 기본 설정 목록에서 CLSID(클래스 식별자)를 가져옵니다.
IMFPluginControl::IsDisabled

CLSID(클래스 식별자)가 차단된 목록에 표시되는지 여부를 쿼리합니다. (IMFPluginControl.IsDisabled)
IMFPluginControl::SetDisabled

차단된 목록에 CLSID(클래스 식별자)를 추가하거나 목록에서 CLSID를 제거합니다. (IMFPluginControl.SetDisabled)
IMFPluginControl::SetPreferredClsid

기본 설정 목록에 CLSID(클래스 식별자)를 추가하거나 목록에서 CLSID를 제거합니다. (IMFPluginControl.SetPreferredClsid)

설명

Media Foundation은 기본 제공 미디어 원본 및 디코더 집합을 제공합니다. 애플리케이션은 다음과 같이 열거할 수 있습니다.

애플리케이션은 이러한 개체를 간접적으로 열거할 수도 있습니다. 예를 들어 애플리케이션이 토폴로지 로더를 사용하여 부분 토폴로지를 resolve 경우 토폴로지 로더는 MFTEnumEx를 호출하여 필요한 디코더를 찾습니다.

제3자는 고유한 사용자 지정 미디어 원본 및 디코더를 구현하고 다른 애플리케이션에서 사용할 수 있도록 열거형에 등록할 수 있습니다.

열거형 순서를 제어하기 위해 Media Foundation은 두 개의 프로세스 전체 CLSID 목록(기본 목록 및 차단된 목록)을 유지 관리합니다. CLSID가 기본 목록에 표시되는 개체가 열거형 순서로 먼저 나타납니다. 차단된 목록에 CLSID가 표시되는 개체는 열거되지 않습니다.

목록은 처음에 레지스트리에서 채워집니다. 애플리케이션은 IMFPluginControl 인터페이스를 사용하여 현재 프로세스의 목록을 수정할 수 있습니다.

기본 목록에는 키가 문자열이고 값이 CLSID인 키/값 쌍 집합이 포함됩니다. 이러한 키/값 쌍은 다음과 같이 정의됩니다.

  • 미디어 원본의 경우 키 이름은 파일 이름 확장명, 프로토콜 체계 또는 MIME 형식입니다. 값은 해당 미디어 원본에 대한 스키마 처리기 또는 바이트 스트림 처리기의 CLSID입니다.
  • 디코더의 경우 키 이름은 정식 문자열 형식의 미디어 하위 형식 GUID입니다. (미디어 하위 형식에 대한 자세한 내용은 미디어 형식을 참조하세요.) 값은 디코더를 구현하는 MFT(Media Foundation 변환)의 CLSID입니다.
다음 예제에서는 다양한 유형의 키를 보여 줍니다.
  • 파일 확장명: ".wmv"
  • 체계: "http:"
  • MIME 형식: "video/mp4"
  • 미디어 하위 유형: "{47504A4D-0000-0010-8000-00AA00389B71}"
기본 목록을 키 이름으로 검색하려면 IMFPluginControl::GetPreferredClsid 메서드를 호출합니다. 전체 목록을 열거하려면 루프에서 IMFPluginControl::GetPreferredClsidByIndex 메서드를 호출합니다.

차단된 목록에는 CLSID 목록이 포함되어 있습니다. 전체 목록을 열거하려면 루프에서 IMFPluginControl::GetDisabledByIndex 메서드를 호출합니다. 특정 CLSID가 목록에 표시되는지 여부를 검사 IMFPluginControl::IsDisabled 메서드를 호출합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 mfobjects.h(Mfidl.h 포함)

참고 항목

MFGetPluginControl

미디어 파운데이션 인터페이스