IPinInfo Object
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
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
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.
Connect Method (IPinInfo Object)
IPinInfo Object
Connects two pins, using transform filters as necessary.
Syntax
objPinInfo.Connect objPin
Parts
ConnectDirect Method (IPinInfo Object)
IPinInfo Object
Connects the two pins directly, without using transform filters.
Syntax
objPinInfo.ConnectDirect objPin
Parts
ConnectedTo Property (IPinInfo Object)
IPinInfo Object
Retrieves the IPinInfo object for the pin to which the filter is connected.
Syntax
Set objConnectedPinInfo = objPinInfo.ConnectedTo
Parts
ConnectionMediaType Property (IPinInfo Object)
IPinInfo Object
Retrieves the IMediaTypeInfo object for this connection.
Syntax
Set objMediaTypeInfo = objPinInfo.ConnectionMediaType
Parts
- objMediaTypeInfo
- IMediaTypeInfo object that will contain the new media type.
- objPinInfo
- IPinInfo object specifying the source pin; the objMediaTypeInfo object copies this pin's media type.
Remarks
The IMediaTypeInfo object contains information about the major type and subtype that this pin supports.
ConnectWithType Method (IPinInfo Object)
IPinInfo Object
Connects directly to the specified pin using the specified media type.
Syntax
objPinInfo.ConnectWithType objPin, objMediaType
Parts
Remarks
The Connect and ConnectDirect methods can also be used to connect pins.
Direction Property (IPinInfo Object)
IPinInfo Object
Retrieves the pin direction.
Syntax
objPinInfo.Direction
Parts
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
Remarks
The value 0 indicates input, and the value 1 indicates output.
Disconnect Method (IPinInfo Object)
IPinInfo Object
Disconnects this pin and the corresponding connected pin from each other.
Syntax
objPinInfo.Disconnect
Parts
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
Remarks
Each pin has its own connection to the other. This method disconnects both pins.
FilterInfo Property (IPinInfo Object)
IPinInfo Object
Retrieves the IFilterInfo object for the filter that contains the current pin.
Syntax
Set objFilterInfo = objPinInfo.FilterInfo
Parts
- objFilterInfo
- Object expression that evaluates to an IFilterInfo object.
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
Remarks
For more information, see the reference entry for IFilterInfo.
MediaTypes Property (IPinInfo Object)
IPinInfo Object
Retrieves the IAMCollection object that specifies the preferred media types for the current pin.
Syntax
Set objCollection = objPinInfo.MediaTypes
Parts
- objCollection
- IAMCollection object that is returned.
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
Name Property (IPinInfo Object)
IPinInfo Object
Retrieves the name of this pin.
Syntax
objPinInfo.Name
Parts
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
Pin Property (IPinInfo Object)
IPinInfo Object
Returns the IPin object.
Syntax
Set objPin = objPinInfo.Pin
Parts
Remarks
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.
PinID Property (IPinInfo Object)
IPinInfo Object
Retrieves the pin identifier.
Syntax
objPinInfo.PinID
Parts
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
Remarks
You can pass the PinID as a parameter to the FindPin method of the IFilterInfo object.
Render Method (IPinInfo Object)
IPinInfo 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.
Syntax
objPinInfo.Render
Parts
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
Remarks
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.
Top of Page
© 2000 Microsoft and/or its suppliers. All rights reserved. Terms of Use.