DirectShow DirectShow 레퍼런스 인터페이스 IFileSinkFilter2 [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
IFileSinkFilter2 인터페이스는 IFileSinkFilter 인터페이스로부터 파생해, 이 인터페이스에 옮겨지는 것이다. IFileSinkFilter 같이, 미디어 스트림을 파일에 기입하는 필터에서는, 이 인터페이스를 처리 한다. 예를 들어, 비디오 캡춰용 필터 그래프의 파일 싱크 필터는, 압축 필터의 출력을 파일에 보존한다. 보통, 이 필터 그래프를 실행하는 애플리케이션에서는, 사용자가 보존처의 파일명을 입력할 수 있어야 한다. 이 인터페이스를 사용하면 그 정보를 교환할 수 있다. IFileSinkFilter2 에는, 이미 같은 이름의 파일이 있는 경우에 기존 파일을 파기해야할 것인가 제발을 결정하는 옵션이 더해지고 있다. 비디오 캡춰의 경우, 파일 용량을 사전에 할당하려면 시간이 걸리기 (위해)때문에, 이미 생성 한 파일을 파기하지 않는 것. 디폴트에서는, 원의 파일은 파기되지 않는다. 그 이외의 경우, 새롭게 기입하는 파일에 불필요한 데이터를 남기지 않기 때문에, 원의 파일이 파기된다.
출력 파일명을 필요로 하는 필터, 또는 출력 파일의 옵션을 설정할 필요가 있는 필터에서는, 이 인터페이스를 처리 해야 한다. 개발하는 필터와 ActiveMovie 1.0 과의 호환성을 유지하려면 , 종래의 IFileSinkFilter 인터페이스를 처리 한다. 현재, 이 인터페이스를 처리 하는 base class는 없다.
파일 싱크 필터의 출력처 파일명을 설정할 필요가 있는 애플리케이션에서는, 이 인터페이스를 사용해, 파일명을 취득 및 설정하는지, 또는 옵션을 변경해야 한다. 개발하는 애플리케이션과 ActiveMovie 1.0 과의 호환성을 유지하려면 , 종래의 IFileSinkFilter 인터페이스를 사용하는 것.
IFileSinkFilter 인터페이스는,IFileSinkFilter 로부터 계승하는 메서드 이외에 이하의 메서드도 공개한다.
메서드 | 설명 |
SetMode | 신규 파일의 생성시에 파일 라이터가 파일을 파기할지 어떨지를 결정한다. |
GetMode | 신규 파일의 생성시에 파일 라이터가 파일을 파기할지 어떨지를 얻어온다. |