KSTOPOLOGY_CONNECTION structure

[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.]

This topic applies to Windows XP Service Pack 2 or later.

The KSTOPOLOGY_CONNECTION structure describes a node connection within a kernel-streaming (KS) filter. A node can be connected to another node within the filter, or to a pin on the filter.

Syntax

typedef struct {
  ULONG FromNode;
  ULONG FromNodePin;
  ULONG ToNode;
  ULONG ToNodePin;
} KSTOPOLOGY_CONNECTION, *PKSTOPOLOGY_CONNECTION;

Members

FromNode

Index of the upstream node in the connection. If the upstream connection is a pin, rather than a node, the value is KSFILTER_NODE.

FromNodePin

If the value of the FromNode field is KSFILTER_NODE, this field specifies the index of the upstream pin. Otherwise, this field is ignored.

ToNode

Index of the downstream node in the connection. If the downstream connection is a pin, rather than a node, the value is KSFILTER_NODE.

ToNodePin

If the value of the ToNode field is KSFILTER_NODE, this field specifies the index of the downstream pin. Otherwise, this field is ignored.

Requirements

Requirement	Value
Header	Ks.h

See also

DirectShow Structures

IKsTopologyInfo::get_ConnectionInfo