IMemAllocator 인터페이스(strmif.h)

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

인터페이스는 IMemAllocator 핀 간에 데이터를 이동하기 위해 미디어 샘플을 할당합니다.

이 인터페이스는 입력 핀이 IMemInputPin 인터페이스를 노출할 때 할당자를 공유하는 핀에서 사용됩니다. 핀은 할당자를 제공할 핀을 협상합니다. 할당자는 메모리 버퍼를 할당하고, 빈 버퍼를 검색하고, 버퍼를 해제하는 데 사용됩니다. 모든 필터가 자체 할당자를 만드는 것은 아니므로 여러 필터에서 하나의 할당자를 사용할 수 있습니다. 자세한 내용은 필터 연결 방법을 참조하세요.

애플리케이션은 일반적으로 이 인터페이스를 사용하지 않습니다.

할당자를 사용하려면 다음 단계를 수행합니다.

1. IMemAllocator::SetProperties 메서드를 호출하여 버퍼 수와 각 버퍼의 크기를 포함하여 버퍼 요구 사항을 지정합니다.
2. IMemAllocator::Commit 메서드를 호출하여 버퍼를 할당합니다.
3. IMemAllocator::GetBuffer 메서드를 호출하여 미디어 샘플을 검색합니다. 이 메서드는 다음 샘플을 사용할 수 있게 될 때까지 차단합니다.
4. 각 샘플을 완료하면 샘플에서 IUnknown::Release 메서드를 호출합니다. 참조 수가 0에 도달하면 샘플이 삭제되지 않습니다. 대신 샘플은 할당자의 무료 목록으로 돌아갑니다.
5. 할당자 사용을 완료하면 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 포함)