IAMDevMemoryAllocator Interface (Compact 2013)
3/26/2014
This interface enables the creation of third-party memory allocators by using an on-board memory manager object. Many codec hardware manufacturers put on-board mapped memory for the codecs to improve the efficiency of buffer manipulation. This interface allocates that memory and provides the GetDevMemoryObject method to retrieve a device memory control object, which supports the IAMDevMemoryControl interface. Devices that share the same device ID can use the memory.
The global memory manager object exposes this interface to allocate memory from memory that is on a particular device.
When to Implement
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 do not 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.
When to Use
Use this interface when applications need to control the memory of codecs with on-board memory.
Methods in Vtable Order
The following table shows the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.
IAMDevMemoryAllocator method |
Description |
|---|---|
Retrieves information about the memory capabilities. |
|
Tests whether a memory pointer was allocated by the specific instance (device) of the allocator. |
|
Allocates a memory buffer. |
|
Frees the previously allocated memory. |
|
Retrieves an IUnknown interface pointer to a device memory control object that can be aggregated with a custom allocator. |
Requirements
Header |
dshow.h |
Library |
Strmiids.lib |