Microsoft DirectX 9.0

IAMDevMemoryAllocator Interface

Note   This interface has been deprecated. It was defined to support older hardware decoders that required AVI files to be read into directly hardware memory. The interface enables the AVI parser to allocate memory from the downstream filter but still provide its own allocator. There should be no need for any newer devices to support this interface.

Implement this interface when your pin must support the creation of on-board memory allocators. Source filters that are aware of on-board memory and need to create their own allocators should query for this interface, request an amount of memory and then create an allocator (aggregating the device memory control object). Source filters that don't need to create their own allocator could just use the allocator of the downstream pin (which also aggregates the device memory control object). The hardware-based filter can confirm the usage of its on-board memory by calling methods on the aggregated allocator.

Use this interface when applications need to control the memory of codecs with on-board memory.

In addition to the methods inherited from IUnknown, the IAMDevMemoryAllocator interface exposes the following methods.

Method Description
Alloc Allocates a memory buffer.
CheckMemory Tests whether the particular device of the allocator allocated a memory pointer.
Free Frees the previously allocated memory.
GetDevMemoryObject Retrieves an IUnknown interface pointer to a device memory control object that can be aggregated with a custom allocator.
GetInfo Retrieves information about the memory capabilities.