IAMCrossbar::Route

 
Microsoft DirectShow 9.0

IAMCrossbar::Route

The Route method routes an input pin to an output pin.

Syntax

  HRESULT Route (
  long OutputPinIndex,
  long InputPinIndex
);

Parameters

OutputPinIndex

[in]  Specifies the index of the output pin.

InputPinIndex

[in]  Specifies the index of the input pin.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description
S_FALSE Cannot route these two pins.
S_OK Success.

Remarks

Routing two pins causes the output pin to deliver data from that input pin. Only one input pin at a time can be routed to a given output pin.

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