CBaseAllocator.ReleaseBuffer 메서드

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 ReleaseBuffer 미디어 샘플을 무료 미디어 샘플 목록에 반환합니다. 이 메서드는 IMemAllocator::ReleaseBuffer 메서드를 구현합니다.

구문

HRESULT ReleaseBuffer(
   IMediaSample *pSample
);

매개 변수

pSample

미디어 샘플 개체의 IMediaSample 인터페이스에 대한 포인터입니다.

반환 값

S_OK 반환합니다.

설명

미디어 샘플의 참조 수가 0에 도달하면 샘플은 자신을 매개 변수로 사용하여 ReleaseBuffer 를 호출합니다. 이 메서드는 다음 작업을 수행합니다.

• 미디어 샘플을 무료 목록(CBaseAllocator::m_lFree)으로 반환합니다.
• CBaseAllocator::NotifySample 메서드를 호출합니다. 이 메서드는 CBaseAllocator::GetBuffer 메서드를 호출할 때 차단된 모든 스레드를 해제합니다.
• CBaseAllocator::SetNotify 메서드가 이전에 호출된 경우 IMemAllocatorNotifyCallbackTemp::NotifyRelease 메서드를 호출합니다.
• 마지막 샘플이 릴리스될 때 보류 중인 CBaseAllocator::D ecommit 호출이 있는 경우 CBaseAllocator::Free 메서드를 호출하여 버퍼 메모리를 해제합니다. (기본 클래스에서 Free 는 순수 가상 메서드입니다.)

요구 사항

요구 사항	값
헤더	Amfilter.h(Streams.h 포함)
라이브러리	Strmbase.lib(소매 빌드); Strmbasd.lib(디버그 빌드)

추가 정보

CBaseAllocator 클래스