DirectShow 보유 사용이 금지되고 있는 인터페이스 IFilterMapper RegisterFilter   [목차열람] [주소복사] [슬롯비우기]

IFilterMapper::RegisterFilter

주 :  IFilterMapper 인터페이스의 사용은 피하는 것. 대신에,IFilterMapper2 를 사용하는 것.

레지스트리에 필터를 추가한다. 이 필터는 열거할 수 있다.

구문

HRESULT RegisterFilter(
    CLSID clsid,
    LPCWSTR Name,
    DWORD dwMerit
);

파라미터

clsid

[in] 필터의 글로벌 일의 식별자 (GUID).

Name

[in] 필터의 내용을 나타내요 셋집 들이마셔 이름.

dwMerit

[in] 열거에서의 우선 순위. 메리트값이 높은 필터(정도)만큼 먼저 열거된다.

반환값

HRESULT 값을 돌려준다.

주의

메리트 (dwMerit 인수로 정의한다)는,IGraphBuilder::Connect ,IGraphBuilder::Render , 또는 IGraphBuilder::RenderFile 의 호출에 의해 필터 그래프 매니저가 조작을 실행할 경우에, 필터를 시험하는 순서를 제어한다. 필터 그래프 매니저는, 올바른 미디어 타입으로 등록되어 있는 필터를 모두 검색한 데다가, 가장 메리트의 높은 것을 시험한다. 이 때, 메리트가 동일한 필터가 다수 있으면, 등록되어 있는 그 외의 조건에 근거해 선택한다.

참조

• 에러 코드와 성공 코드
• IFilterMapper 인터페이스