IPin Interface

Microsoft DirectShow 9.0

IPin Interface

This interface is exposed by all input and output pins.

The filter graph manager uses this interface to connect pins and perform flushing operations. Applications can use this interface to query the pin for information. Applications should never call IPin methods that change a pin's state, such as Connect, Disconnect, BeginFlush, or EndFlush. To connect pins, an application must use the methods in IGraphBuilder.

Filter developers: The CBasePin, CBaseInputPin, and CBaseOutputPin classes implement this interface. Other base classes derive from these three classes.

In addition to the methods inherited from IUnknown, the IPin interface exposes the following methods.

Method	Description
Connect	Connects the pin to another pin.
ReceiveConnection	Accepts a connection from another pin.
Disconnect	Breaks the current pin connection.
ConnectedTo	Retrieves the pin connected to this pin.
ConnectionMediaType	Retrieves the media type for the current pin connection.
QueryPinInfo	Retrieves information about the pin, such as the name, the owning filter, and the direction.
QueryId	Retrieves the pin identifier.
QueryAccept	Determines whether the pin accepts a specified media type.
EnumMediaTypes	Enumerates the pin's preferred media types.
QueryInternalConnections	Retrieves the pins that are connected internally to this pin (within the filter).
EndOfStream	Notifies the pin that no additional data is expected.
BeginFlush	Begins a flush operation.
EndFlush	Ends a flush operation.
NewSegment	Notifies the pin that media samples received after this call are grouped as a segment.
QueryDirection	Retrieves the direction of the pin (input or output).

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.