Hardware Dev Center

Expand Minimize

KSTOPOLOGY_CONNECTION structure

The KSTOPOLOGY_CONNECTION structure describes a single data-path connection inside a kernel streaming filter.

Syntax


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

Members

FromNode

Specifies the node ID of the node on the upstream end of the connection. If this end of the connection is an external pin on the filter -- not a logical pin on a node--set this member to the null node-ID value, KSFILTER_NODE.

FromNodePin

Specifies the pin ID for the upstream end of the connection. If FromNode is KSFILTER_NODE, the pin on this end of the connection is an external pin on the filter. If not, the pin on this end is a logical pin on an internal node.

ToNode

Specifies the node ID of the node on the downstream end of the connection. If this end of the connection is an external pin on the filter--not a logical pin on a node -- set this member to the null node-ID value, KSFILTER_NODE.

ToNodePin

Specifies the pin ID for the downstream end of the connection. If ToNode is KSFILTER_NODE, the pin on this end of the connection is an external pin on the filter. If not, the pin on this end is a logical pin on an internal node.

Remarks

KSTOPOLOGY_CONNECTION represents a single connection inside a filter, between either external pins, internal nodes, or an external pin and an internal node.

A streaming driver returns an array of KSTOPOLOGY_CONNECTION structures in response to a KSPROPERTY_TOPOLOGY_CONNECTIONS get-property request.

When representing a connection between two external pins, both FromNode and ToNode should be set to KSFILTER_NODE, and the FromNodePin and ToNodePin should be the pin type ID of the respective pins. (See KSPROPSETID_Pin for a description of pin type IDs.)

Otherwise, FromNodePin or ToNodePin represent a logical incoming or outgoing pin for the connection. The logical pin numbers are used solely to describe a connection between nodes; they have no existence outside of the KSPROPERTY_TOPOLOGY_CONNECTIONS property.

The PCCONNECTION_DESCRIPTOR structure name is an alias for KSTOPOLOGY_CONNECTION.

Requirements

Header

Ks.h (include Ks.h)

See also

BdaPropertyTemplateConnections
PCCONNECTION_DESCRIPTOR
KSPROPERTY_TOPOLOGY_CONNECTIONS
KSPROPSETID_Pin
KSPROPSETID_Topology

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft