The IAMCrossbar interface is exposed on analog video crossbar filters and is used to route messages from an analog or digital audio or video source to a video capture filter. The crossbar filter is modeled after a general switching matrix, with n inputs and m outputs. Any of the input signals can be routed to one or more of the outputs.
A single crossbar can route both video and audio signals. Video pins can optionally be used an audio pin to route the audio portion of a combined signal.
This filter is based on a simple multiplexer.
When to Implement
Implement this interface when your filter needs to route analog or digital signals to a capture filter.
When to Use
Use this interface when your application needs to route analog or digital video signals through a crossbar filter.
Methods in Vtable Order
IUnknown methods | Description |
QueryInterface | Retrieves pointers to supported interfaces. |
AddRef | Increments the reference count. |
Release | Decrements the reference count. |
IAMCrossbar methods | Description |
get_PinCounts | Retrieves the number of input and output pins. |
CanRoute | Determines if the crossbar filter can route the analog or digital signal. |
Route | Routes an input pin to an output pin. |
get_IsRoutedTo | Retrieves the input pin connected to a given output pin. |
get_CrossbarPinInfo | Retrieves a pin that has audio or video data relating to a given pin. |
Retrieves the number of input and output pins.
HRESULT get_PinCounts(
long * OutputPinCount,
long * InputPinCount
);
Returns an HRESULT value that depends on the implementation of the interface.
Determines if routing is possible.
HRESULT CanRoute (
long OutputPinIndex,
long InputPinIndex
);
Returns an HRESULT value that depends on the implementation of the interface.
Routes an input pin to an output pin.
HRESULT Route (
long OutputPinIndex,
long InputPinIndex
);
Returns an HRESULT value that depends on the implementation of the interface.
Pin indexes are zero based.
Retrieves the input pin connected to a given output pin.
HRESULT get_IsRoutedTo (
long OutputPinIndex,
long * InputPinIndex
);
Returns an HRESULT value that depends on the implementation of the interface.
Retrieves a pin that has audio or video data relating to a given pin.
HRESULT get_CrossbarPinInfo (
BOOL IsInputPin,
long PinIndex,
long * PinIndexRelated,
long * PhysicalType
);
Returns an HRESULT value that depends on the implementation of the interface.
This method retrieves, for example, the audio pin related to a given video pin.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.