IAMCrossbar::get_CrossbarPinInfo

  • Article
 
Microsoft DirectShow 9.0

IAMCrossbar::get_CrossbarPinInfo

The get_CrossbarPinInfo method retrieves information about a specified pin.

Syntax

  HRESULT get_CrossbarPinInfo (
  BOOL IsInputPin,
  long PinIndex,
  long *PinIndexRelated,
  long *PhysicalType
);

Parameters

IsInputPin

[in]  Specifies the direction of the pin. Use one of the following values.

Value Description
TRUE Input pin
FALSE Output pin

PinIndex

[in]  Specifies the index of the pin.

PinIndexRelated

[out]  Pointer to a variable that receives the index of the related pin, or -1 if no pin is related to this pin. The related pin is a pin on the same filter, with the same direction; it typically represents the same physical jack or connector. For example, a video tuner and an audio tuner might be related pins. Typically, if two pins are related, you should route them together. 

PhysicalType

[out]  Pointer to a variable that receives a member of the PhysicalConnectorType enumeration, indicating the pin's physical type.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description
S_FALSE Unknown physical type.
S_OK Success.
E_POINTER NULL pointer argument.

Remarks

Output pins and input pins are both indexed from zero. To determine the number of output and input pins, call the IAMCrossbar::get_PinCounts method.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also