DirectShow DirectShow 레퍼런스 DirectShow 의 필터 샘플 grabber 필터   [목차열람] [주소복사] [슬롯비우기]
샘플 grabber 필터
 
Microsoft DirectX 9.0

샘플 grabber 필터

샘플 grabber 필터는, 샘플이 필터 그래프를 통과할 경우에 그것을 얻어온다 방법을 제공한다. 이 필터는, 1 개의 입력 핀과 1 개의 출력 핀을 가지는 변환 필터이다. 모든 샘플을 그대로 다운 스트림에 건네주므로, 데이터 스트림을 변경하지 않고 필터 그래프에 삽입할 수가 있다. 이것에 의해, 애플리케이션은 ISampleGrabber 인터페이스로 메서드를 호출하는 것으로, 필터로부터 각각의 샘플을 취득할 수 있다.

데이터를 렌더링 하지 않고 샘플을 얻어온다 경우는, 샘플 grabber 필터를 Null 렌더링 필터에 접속한다.

필터 인터페이스 IBaseFilter ,ISampleGrabber
입력 핀 미디어 타입 임의의 미디어 타입.
입력 핀인타페이스 IMemInputPin ,IPin ,IQualityControl
출력 핀 미디어 타입 임의의 미디어 타입. 입력 미디어 타입과 같다.
출력 핀인타페이스 IMediaPosition ,IMediaSeeking ,IPin ,IQualityControl
필터 CLSID CLSID_SampleGrabber
프로퍼티 페이지 CLSID 프로퍼티 페이지 없음.
실행 모듈 Qedit.dll
메리트 MERIT_DO_NOT_USE
필터 카테고리 CLSID_LegacyAmFilterCategory

주의

이 필터를 사용하려면 , 필터 그래프에 추가한 후, 임의의 미디어 타입으로 ISampleGrabber::SetMediaType 를 호출한다. 이 메서드는, 필터의 입력 핀과 출력 핀의 접속의 미디어 타입을 지정한다. 그 후, 필터를 그래프내의 다른 필터에 접속한다.

ISampleGrabber::SetBufferSamples 를 값 TRUE 로 호출하면, 이 필터는, 받은 각 샘플을, 다운 스트림에 건네주기 전에 버퍼 한다. 버퍼의 현재의 내용을 얻어오려면,ISampleGrabber::GetCurrentBuffer 메서드를 호출한다. 또는,ISampleGrabber::SetCallback 를 호출해, 필터가 샘플을 받았을 때에 콜백 함수를 기동시킬 수도 있다.

이 필터는, 탑 다운 방향 (부의 biHeight)이나 포맷 타입 FORMAT_VideoInfo2 의 비디오 타입을 지원 하고 있지 않다. 또, 표면의 보폭이 비디오의 폭과 일치하지 않는 비디오 타입을 거부한다. 이것은, 일부의 비디오 타입의 경우, 샘플 grabber가 Video Mixing Renderer (VMR)에 접속하지 않는 것을 의미한다.

참조

↑TOP