DirectShow DirectShow 레퍼런스 DirectShow base class base class 레퍼런스 CMediaSample   [목차열람] [주소복사] [슬롯비우기]

CMediaSample 클래스

CMediaSample 클래스는,IMediaSample2 인터페이스를 지원 하는 미디어 샘플을 정의한다. 미디어 샘플은 메모리 버퍼의 포인터와 프로텍트 멤버 변수에 저장 되고 있는 몇개의 프로퍼티를 갖는다.

미디어 샘플은 CBaseAllocator 클래스로부터 파생하는 할당자에 의해 생성 된다. CMediaSample 생성자은 버퍼 사이즈와 함께 할당자 버퍼의 포인터를 받는다. 다른 프로퍼티는 보통 IMediaSample 인터페이스 메서드를 통해 설정 또는 취득된다.

미디어 샘플의 라이프 사이클은 대부분의 COM 개체의 라이프 사이클과는 다르다.

• 할당자는 프리 샘플의 리스트를 보관 유지한다. 필터가 새로운 샘플을 필요로 할 때, 할당자의 IMemAllocator::GetBuffer 메서드를 호출한다. 할당자는 그 면세표로부터 샘플을 취득해, 그 샘플의 참조 카운트를 인크리먼트(increment) 해, 그 샘플의 포인터를 돌려준다.
• 필터가 샘플에서의 처리를 종료했을 때, 샘플의 IUnknown::Release 메서드를 호출한다. 대부분의 개체와는 달라, 참조 카운트가 제로가 되어도 샘플은 자신을 삭제하지 않는다. 그 대신에, 할당자의 IMemAllocator::ReleaseBuffer 메서드를 호출해, 할당자는 면세표에 그 샘플을 돌려준다.
• 할당자는 IMemAllocator::Decommit 가 불려 갈 때까지 샘플을 삭제하지 않는다.

요건

헤더: Amfilter.h 로 선언해, Streams.h 를 인클루드 한다.

라이브러리: Strmbase.lib (리테일 빌드) 또는 Strmbasd.lib (디버그 빌드).