Export (0) Print
Expand All
4 out of 4 rated this helpful - Rate this topic

IKsTopologyInfo interface

The IKsTopologyInfo interface enumerates the nodes in a stream class driver. The KsProxy filter exposes this interface. Applications can use this interface to examine the internal topology of a kernel-mode filter.

Members

The IKsTopologyInfo interface inherits from the IUnknown interface. IKsTopologyInfo also has these types of members:

Methods

The IKsTopologyInfo interface has these methods.

MethodDescription
CreateNodeInstance

Creates a COM object that represents a node in the filter.

get_Category

Returns one of the filter categories for this stream class driver.

get_ConnectionInfo

Returns information about one node connection in the filter.

get_NodeName

Returns the name of the node.

get_NodeType

Returns the node type for a given node.

get_NumCategories

Returns the number of categories for this filter.

get_NumConnections

Returns the number of node connections within the filter.

get_NumNodes

Returns the number of nodes in the filter.

 

Remarks

In the Windows Driver Model, a kernel-streaming (KS) filter contains one or more nodes. Each node encapsulates a processing task that is applied to the stream. Nodes have inputs and outputs, which connect either to other nodes in the filter, or else to the filter's pins. In this way, the nodes resemble a miniature "filter graph" inside the filter, which may contain several possible data paths. Applications can use the IKsTopologyInfo interface to get information about the nodes and the node connections.

KsFilter nodes

Some devices also support the ISelector interface for selecting input nodes. For example, if a video capture device has a camera and a tape transport, these could be represented as two nodes (see the previous diagram).

Include Vidcap.h from the Windows SDK or from the DirectX 9.0 SDK Update (Summer 2004) or later.

Requirements

Minimum supported client

Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Vidcap.h

See also

Working with USB DV Video Devices

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.