IMemAllocator 인터페이스(strmif.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
인터페이스는 IMemAllocator
핀 간에 데이터를 이동하기 위해 미디어 샘플을 할당합니다.
이 인터페이스는 입력 핀이 IMemInputPin 인터페이스를 노출할 때 할당자를 공유하는 핀에서 사용됩니다. 핀은 할당자를 제공할 핀을 협상합니다. 할당자는 메모리 버퍼를 할당하고, 빈 버퍼를 검색하고, 버퍼를 해제하는 데 사용됩니다. 모든 필터가 자체 할당자를 만드는 것은 아니므로 여러 필터에서 하나의 할당자를 사용할 수 있습니다. 자세한 내용은 필터 연결 방법을 참조하세요.
애플리케이션은 일반적으로 이 인터페이스를 사용하지 않습니다.
할당자를 사용하려면 다음 단계를 수행합니다.
- IMemAllocator::SetProperties 메서드를 호출하여 버퍼 수와 각 버퍼의 크기를 포함하여 버퍼 요구 사항을 지정합니다.
- IMemAllocator::Commit 메서드를 호출하여 버퍼를 할당합니다.
- IMemAllocator::GetBuffer 메서드를 호출하여 미디어 샘플을 검색합니다. 이 메서드는 다음 샘플을 사용할 수 있게 될 때까지 차단합니다.
- 각 샘플을 완료하면 샘플에서 IUnknown::Release 메서드를 호출합니다. 참조 수가 0에 도달하면 샘플이 삭제되지 않습니다. 대신 샘플은 할당자의 무료 목록으로 돌아갑니다.
- 할당자 사용을 완료하면 IMemAllocator::D ecommit 메서드를 호출하여 버퍼에 대한 메모리를 해제합니다.
상속
IMemAllocator 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IMemAllocator 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IMemAllocator 인터페이스에는 이러한 메서드가 있습니다.
IMemAllocator::Commit Commit 메서드는 버퍼 메모리를 할당합니다. |
IMemAllocator::D ecommit Decommit 메서드는 버퍼 메모리를 해제합니다. |
IMemAllocator::GetBuffer GetBuffer 메서드는 빈 버퍼가 포함된 미디어 샘플을 검색합니다. |
IMemAllocator::GetProperties GetProperties 메서드는 할당자가 만들 버퍼 수와 버퍼 속성을 검색합니다. |
IMemAllocator::ReleaseBuffer ReleaseBuffer 메서드는 미디어 샘플을 릴리스합니다. |
IMemAllocator::SetProperties SetProperties 메서드는 할당할 버퍼 수와 각 버퍼의 크기를 지정합니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | strmif.h(Dshow.h 포함) |