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.
The IKsTopologyInfo interface inherits from the IUnknown interface. IKsTopologyInfo also has these types of members:
The IKsTopologyInfo interface has these methods.
Creates a COM object that represents a node in the filter.
Returns one of the filter categories for this stream class driver.
Returns information about one node connection in the filter.
Returns the name of the node.
Returns the node type for a given node.
Returns the number of categories for this filter.
Returns the number of node connections within the filter.
Returns the number of nodes in the filter.
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.
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.
Minimum supported client
|Windows XP with SP2 [desktop apps only]|
Minimum supported server
|Windows Server 2003 R2 [desktop apps only]|