Skip to content

Latest commit

 

History

History
117 lines (91 loc) · 3.46 KB

nf-strmif-iamcrossbar-route.md

File metadata and controls

117 lines (91 loc) · 3.46 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:strmif.IAMCrossbar.Route
IAMCrossbar::Route (strmif.h)
The Route method routes an input pin to an output pin.
IAMCrossbar interface [DirectShow]
Route method
IAMCrossbar.Route
IAMCrossbar::Route
IAMCrossbarRoute
Route
Route method [DirectShow]
Route method [DirectShow]
IAMCrossbar interface
dshow.iamcrossbar_route
strmif/IAMCrossbar::Route
dshow\iamcrossbar_route.htm
dshow
a3f6823d-e389-478a-b882-2556a3cbd821
4/26/2023
IAMCrossbar interface [DirectShow],Route method, IAMCrossbar.Route, IAMCrossbar::Route, IAMCrossbarRoute, Route, Route method [DirectShow], Route method [DirectShow],IAMCrossbar interface, dshow.iamcrossbar_route, strmif/IAMCrossbar::Route
strmif.h
Dshow.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Strmiids.lib
Windows
19H1
IAMCrossbar::Route
strmif/IAMCrossbar::Route
c++
APIRef
kbSyntax
COM
Strmiids.lib
Strmiids.dll
IAMCrossbar.Route

IAMCrossbar::Route

-description

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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

-parameters

-param OutputPinIndex [in]

Specifies the index of the output pin.

-param InputPinIndex [in]

Specifies the index of the input pin.

-returns

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.

-see-also

Error and Success Codes

IAMCrossbar Interface

Working with Crossbars