Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This interface provides methods on an input pin to facilitate passing data and flush notifications from a connected output pin of an upstream filter.

When to Implement

Implement this interface on the input pin of every filter.

The CBaseInputPinclass implements this interface.

When to Use

A connected output pin uses this interface to retrieve an IMemAllocatorinterface, to pass media samples to the input pin, and to flush pending buffers downstream.

Methods in Vtable Order

The following table shows the methods that appear in the Vtable beneath the standard COM methods inherited from IUnknown.

Method Description

GetAllocator

Returns the allocator interface that this input pin proposes as the interface for the output pin to use.

NotifyAllocator

Notifies the input pin as to which allocator the output pin is actually going to use.

GetAllocatorRequirements

Optional method to use if the filter has specific alignment or prefix requirements but could use an upstream allocator.

Receive

Receives the next block of data from the stream.

ReceiveMultiple

Receives the next block of data from the stream.

This method behaves similarly to the IMemInputPin::Receivemethod, but it works with multiple samples.

ReceiveCanBlock

Determines if sending the IMemInputPin::Receivemethod might block.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment

See Also