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
Get | Set | Target | Property Descriptor Type | Property Value Type |
---|---|---|---|---|
Yes |
Yes |
Pin |
HANDLE |
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.
Header |
Ks.h (include Ks.h) |