ITAllocatorProperties interface (tapi3ds.h)

The ITAllocatorProperties interface exposes the buffer allocator properties of the Media Streaming Terminal (MST) to an end-user or server application. An application needs to tune the sample size for a particular protocol. The decision concerning appropriate properties is highly implementation dependent.

This interface is exposed on the Terminal Object by the associated Media Service Provider. If it exists, a QueryInterface on any Terminal interface, such as ITTerminal, can be used to obtain an ITAllocatorProperties pointer.


The ITAllocatorProperties interface inherits from the IUnknown interface. ITAllocatorProperties also has these types of members:


The ITAllocatorProperties interface has these methods.


The GetAllocateBuffers method determines whether the current allocator buffers can be retrieved. If it returns FALSE, the sample that the MST allocated doesn't have any buffers and they must be supplied before Update is called on the samples.

The GetAllocatorProperties method gets the current values for the allocator properties after connection and provides the negotiated values. This method is invalid before connection. The MST will accept any values suggested by the connected filters.

The GetBufferSize method gets the size of the allocator buffer.

The SetAllocateBuffers method determines whether the current allocator buffers must be set.

The SetAllocatorProperties method must be called before connection and will force the MSP to use these values during filter negotiation. If the connecting filter doesn't accept these values, the connection is not established.

The SetBufferSize method sets the size of the allocator buffer.


Target Platform Windows
Header tapi3ds.h (include Tapi3.h)