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

CBaseAllocator 클래스

The CBaseAllocator 클래스는, 할당자를 처리 하는 추상 base class이다. 할당자는 IMemAllocator 인터페이스를 공개한다.

allocator 는 메모리 버퍼를 할당하는 개체이다. 할당자는 사용 가능한 버퍼의 리스트를 보관 유지한다. 클라이언트 (일반적으로는 필터)가 버퍼를 요구 하면, 할당자는 리스트로부터 버퍼를 얻어온다. 클라이언트는 버퍼에 데이터를 저장 한다. 버퍼를 다른 개체에 건네주는 경우도 있다. 최종적으로 버퍼는 릴리즈 되어 할당자는 릴리즈 된 버퍼를 사용 가능한 버퍼의 리스트에 되돌린다.

각 버퍼는미디어 샘플을 호출하는 개체에 의해 캡슐화된다. 미디어 샘플은 COM (Component Object Model) 프레임워크(framework)를 사용해 포인터를 메모리 블록에 패키지 하는 1 개의 방법이다. 미디어 샘플은 IMediaSample 인터페이스를 공개해,CMediaSample 클래스를 사용해 처리 된다. 미디어 샘플은,IMediaSample::GetPointer 의 호출에 의해 액세스 할 수 있는 관련지을 수 있었던 버퍼의 포인터를 포함한다. 더 자세한 정보는, 「샘플과 할당자」를 참조할것.

이 클래스를 사용하려면 , 다음의 스텝을 실행한다.

1. CBaseAllocator::SetProperties 메서드를 호출해, 버퍼의 수와 각 버퍼의 사이즈를 포함한 버퍼 요구를 지정한다.
2. CBaseAllocator::Commit 메서드를 호출해, 버퍼를 할당한다.
3. CBaseAllocator::GetBuffer 메서드를 호출해, 미디어 샘플을 얻어온다. 이 메서드는 다음 샘플이 사용 가능하게 될 때까지 블록 한다.
4. 각 샘플에서의 처리가 종료하면 샘플에 대해서 IUnknown::Release 메서드를 호출한다. 샘플은 그 참조 카운트가 제로가 되어도 삭제되지 않는다. 대신에, 샘플은 할당자의 면세표에 되돌려진다.
5. 할당자를 다 사용했으면,CBaseAllocator::Decommit 메서드를 호출해 버퍼용의 메모리를 릴리즈 한다.

Commit 메서드는 버퍼의 메모리를 할당하는 가상 메서드 CBaseAllocator::Alloc 를 호출한다. Decommit 메서드는 메모리를 릴리즈 하는 순수 가상 메서드 CBaseAllocator::Free 를 호출한다. 상속 클래스에서는 이 2 개의 메서드를 오버라이드(override) 해야 한다.

CMemAllocator base class는 CBaseAllocator 로부터 파생한다. 필터 base class는 CMemAllocator 클래스를 사용한다.

요건

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

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