IFilterMapper2::RegisterFilter

DirectShow

DirectShow 레퍼런스

인터페이스

IFilterMapper2

RegisterFilter [목차열람] [주소복사] [슬롯비우기]

IFilterMapper2::RegisterFilter

Microsoft DirectX 9.0

IFilterMapper2::RegisterFilter

RegisterFilter 메서드는, 레지스트리에 필터 정보를 추가한다.

구문

HRESULT RegisterFilter(
  REFCLSID clsidFilter,
  LPCWSTR Name,
  IMoniker **ppMoniker,
  const CLSID *pclsidCategory,
  const OLECHAR *szInstance,
  const REGFILTER2 *prf2
);

파라미터

clsidFilter

[in] 필터의 클래스 식별자 (CLSID).

Name

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

ppMoniker

[in, out] 이 필터의 데이터 출력처를 결정하는 디바이스 모니커의 포인터 주소. NULL 도 가능.

pclsidCategory

[in] 필터의 필터 카테고리의 포인터. NULL 의 경우, 디폴트 카테고리는 CLSID_ActiveMovieFilters 이다 ( 「필터 카테고리」를 참조할것).

szInstance

[in] 디바이스 모니커의 표시명을 구축하기 위해서 사용하는 인스턴스 데이터. 프렌들리명에서도, 필터의 CLSID 의 캐릭터 라인 표현이라도 좋다. NULL 의 경우는, 필터의 CLSID 가 사용된다.

prf2

[in] 필터 정보가 저장 된 REGFILTER2 구조체의 포인터.

반환값

HRESULT 값을 돌려준다. 가능한 값은 다음의 일람대로이다.

값	설명
S_OK	성공.
VFW_E_BAD_KEY	레지스트리 키를 취득할 수 없었다.

주의

이 메서드는, 레지스트리내의 지정된 필터 카테고리에 대응하는 레지스트리 엔트리하에, 필터에 관한 정보를 추가한다. 필터를 생성 하는 인 프로세스 서버 (보통은 DLL)를 등록하는 것은 아니다. 서버를 등록하려면 ,AMovieDllRegisterServer2 함수를 호출하면 좋다.

ppMoniker 인수에는, 다음의 어느쪽이든을 사용한다.

기존의 디바이스 모니커에 대한 IMoniker 인터페이스 포인터의 주소
NULL IMoniker 인터페이스 포인터의 주소
NULL

Windows Driver Model (WDM) 장치 또는 플러그 앤 플레이 장치용의 필터를 등록하는 경우는, 기존의 디바이스 모니커의 주소를 건네준다. 이렇게 하면 이 모니카를 사용해 필터가 등록된다. 메서드가 돌아갔을 때,*ppMoniker 에는 NULL 가 설정된다.

그 이외의 경우는, 새로운 모니카가 생성 된다. ppMoniker 가 NULL 가 아닌 경우,*ppMoniker 에 새로운 모니카의 포인터가 설정된다. 그 애플리케이션에서는, 이 모니카를 사용해 프로퍼티 가방에 사적인 값을 추가할 수 있다. 인터페이스는 반드시 릴리즈 하는 것.

모니카를 제공 또는 얻어올 필요가 없는 경우는,ppMoniker 에 NULL 를 설정한다.

참조

↑TOP