The filter graph manager exposes the IPinInfo object, which allows access to pin information such as the media type and the pin direction. It also allows control of pins, such as connecting, disconnecting, and rendering.
Properties
Name | Description |
ConnectedTo | Retrieves the IPinInfo object for the pin to which the filter is connected. |
ConnectionMediaType | Retrieves the media type on this connection. |
Direction | Retrieves the pin direction. |
FilterInfo | Retrieves the IFilterInfo object for the filter to which this pin belongs. |
MediaTypes | Retrieves the IAMCollection object of preferred media types. |
Name | Retrieves the name of this pin. |
Pin | Retrieves the pin associated with this IPinInfo object. |
PinID | Retrieves the pin identifier. |
Methods
Name | Description |
Connect | Connects to the following pin. |
ConnectDirect | Connects directly to the specified pin. |
ConnectWithType | Connects directly to the specified pin using the specified media type only. |
Disconnect | Disconnects this pin and the corresponding connected pin from each other. |
Render | Completes the filter graph downstream from this pin; that is, generates all filters and connections needed to generate a graph from this pin to the renderer filter. |
Connects two pins, using transform filters as necessary.
objPinInfo.Connect objPin
Connects the two pins directly, without using transform filters.
objPinInfo.ConnectDirect objPin
Retrieves the IPinInfo object for the pin to which the filter is connected.
Set objConnectedPinInfo = objPinInfo.ConnectedTo
Retrieves the IMediaTypeInfo object for this connection.
Set objMediaTypeInfo = objPinInfo.ConnectionMediaType
The IMediaTypeInfo object contains information about the major type and subtype that this pin supports.
Connects directly to the specified pin using the specified media type.
objPinInfo.ConnectWithType objPin, objMediaType
The Connect and ConnectDirect methods can also be used to connect pins.
Retrieves the pin direction.
objPinInfo.Direction
The value 0 indicates input, and the value 1 indicates output.
Disconnects this pin and the corresponding connected pin from each other.
objPinInfo.Disconnect
Each pin has its own connection to the other. This method disconnects both pins.
Retrieves the IFilterInfo object for the filter that contains the current pin.
Set objFilterInfo = objPinInfo.FilterInfo
For more information, see the reference entry for IFilterInfo.
Retrieves the IAMCollection object that specifies the preferred media types for the current pin.
Set objCollection = objPinInfo.MediaTypes
Retrieves the name of this pin.
objPinInfo.Name
Returns the IPin object.
Set objPin = objPinInfo.Pin
No IPin programmable object interface is offered for Visual Basic® programmers. This property is provided for use with DLLs that take an IPin parameter, and for use as a parameter in calls to the IPinInfo object's Connect, ConnectDirect, and ConnectWithType methods.
Retrieves the pin identifier.
objPinInfo.PinID
You can pass the PinID as a parameter to the FindPin method of the IFilterInfo object.
Builds a filter graph capable of rendering the media type belonging to this source filter output pin, adding all transform and rendering filters and establishing all connections that are needed.
objPinInfo.Render
This method establishes only those connections that are needed downstream from the specified pin; that is, in the direction of the renderer filter. It differs from the RenderFile method, which establishes a complete filter graph for all pins.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.