DirectShow 보유 사용이 금지되고 있는 인터페이스 IAMFilterData CreateFilterData   [목차열람] [주소복사] [슬롯비우기]
IAMFilterData::CreateFilterData
 
Microsoft DirectX 9.0

IAMFilterData::CreateFilterData

주 :  이 인터페이스의 사용은 피하는 것. 새로운 애플리케이션으로 사용해서는 안 된다.

CreateFilterData 메서드는, 필터에 대한 바이너리 레지스트리 데이터를 생성 한다. 이 데이터는, 필터의 CLSID 키아래의 FilterData 라는 이름의 REG_BINARY 서브 키로서 레지스트리에 기입할 수가 있다.

보통, 애플리케이션으로 이 메서드를 호출할 것은 없다. IFilterMapper2::RegisterFilter 메서드는, 바이너리 데이터를 자동적으로 생성 해, 레지스트리의 올바른 장소에 추가한다. 더 자세한 정보는, 「DirectShow 필터의 등록 방법」을 참조할것.

구문

HRESULT CreateFilterData(
    REGFILTER2 *prf2,
    BYTE **prgbFilterData,
    ULONG *pcb
);

파라미터

prf2

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

prgbFilterData

[out] 바이너리 데이터의 포인터를 받는 변수의 주소. 이 메서드는, 데이터에 메모리를 할당한다. 호출원래는,CoTaskMemFree 메서드를 호출해, 메모리를 릴리즈 해야 한다.

pcb

[out] 바이너리 데이터의 사이즈 (바이트 단위)를 받는 변수의 포인터.

반환값

메서드가 성공했을 경우는, S_OK 를 돌려준다. 실패했을 경우는, 에러 코드를 돌려준다.

요건

fil_data.h 를 인클루드 하는 것. 이 파일은,맵퍼 샘플의 디렉토리에 있다.

참조

↑TOP