Index
|
|
|
|
|
| |||
| |||
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. IPinInfo Object
Connect Method (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.
IPinInfo Object
ConnectDirect Method (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.
IPinInfo Object
ConnectedTo Property (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.
IPinInfo Object
ConnectionMediaType Property (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.
IPinInfo Object
ConnectWithType Method (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.
IPinInfo Object
Direction Property (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.
IPinInfo Object
Disconnect Method (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.
IPinInfo Object
FilterInfo Property (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.
IPinInfo Object
MediaTypes Property (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.
IPinInfo Object
Name Property (IPinInfo Object)Retrieves the name of this pin.
objPinInfo.Name
Parts
- objPinInfo
- Object expression that evaluates to an IPinInfo object.
IPinInfo Object
Pin Property (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.
IPinInfo Object
PinID Property (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.
IPinInfo Object
Render Method (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.
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.