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.