## 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

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.

###

Connect Method (IPinInfo Object)

IPinInfo Object

Connects two pins, using transform filters as necessary.

objPinInfo.Connect objPin

##### Parts

objPinInfo
  Object expression that evaluates to an IPinInfo object.
objPin
  IPinInfo object specifying the other pin in the connection.

###

ConnectDirect Method (IPinInfo Object)

IPinInfo Object

Connects the two pins directly, without using transform filters.

objPinInfo.ConnectDirect objPin

##### Parts

objPinInfo
  IPinInfo object specifying the other pin in the connection.
objPin
  IPinInfo object specifying the other pin in the connection.

###

ConnectedTo Property (IPinInfo Object)

IPinInfo Object

Retrieves the IPinInfo object for the pin to which the filter is connected.

Set objConnectedPinInfo = objPinInfo.ConnectedTo

##### Parts

objConnectedPinInfo
  IPinInfo object for the pin.
objPinInfo
  Object expression that evaluates to an IPinInfo object.

###

ConnectionMediaType Property (IPinInfo Object)

IPinInfo Object

Retrieves the IMediaTypeInfo object for this connection.

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.

objPinInfo.ConnectWithType objPin, objMediaType

##### Parts

objPinInfo
  Object expression that evaluates to an IPinInfo object.
objPin
  IPinInfo object specifying the other pin in the connection.
objMediaType
  Value specifying the media type used in the connection. The objMediaType object must support IPinInfo.

##### Remarks

The Connect and ConnectDirect methods can also be used to connect pins.

###

Direction Property (IPinInfo Object)

IPinInfo Object

Retrieves the pin direction.

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.

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.

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.

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.

objPinInfo.Name

##### Parts

objPinInfo
  Object expression that evaluates to an IPinInfo object.

###

Pin Property (IPinInfo Object)

IPinInfo Object

Returns the IPin object.

Set objPin = objPinInfo.Pin

##### Parts

objPin
  IPinInfo object that will contain the retrieved pin.
objPinInfo
  Object expression that evaluates to an IPinInfo object.

##### 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.

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.

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.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.