KSPROPERTY_STREAM_ALLOCATOR

The KSPROPERTY_STREAM_ALLOCATOR property is an optional property that should be implemented if the pin allocates stream buffers or can provide an allocator

Usage Summary Table

Get Set Target Property Descriptor Type Property Value Type

Yes

Yes

Pin

KSPROPERTY

HANDLE

Remarks

The returned value is always a NULL handle. However, support is determined by whether the call returns successfully.

The property sets the handle of the allocator assigned to the stream connection point. A connection point for KSPIN_COMMUNICATION_SOURCE checks the property to determine the handle of the allocator that should be used for data allocations. This property is typically set by a graph manager such as DirectShow.

An allocator handle is obtained and can be used to set the allocator for another filter pin. A filter using the allocator must reference the object to obtain a pointer to a file object and dereference the file object when a new allocator is assigned or when the connection is closed. The property can also be queried to determine if this connection point supports providing an allocator.

Requirements

Header

Ks.h (include Ks.h)

See also

KSPROPERTY