IAMCrossbar::get_CrossbarPinInfo method (strmif.h)

The get_CrossbarPinInfo method retrieves information about a specified pin.

Syntax

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

Parameters

IsInputPin

Specifies the direction of the pin. Use one of the following values.

Value Meaning
TRUE
Input pin
FALSE
Output pin

PinIndex

Specifies the index of the pin.

PinIndexRelated

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

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

Return value

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

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)
Library Strmiids.lib

See also

Error and Success Codes

IAMCrossbar Interface

Working with Crossbars