KsFilterAddTopologyConnections function (ks.h)

The KsFilterAddTopologyConnections function adds new topology connections to a filter.

Syntax

KSDDKAPI NTSTATUS KsFilterAddTopologyConnections(
  [in] PKSFILTER                           Filter,
  [in] ULONG                               NewConnectionsCount,
  [in] const KSTOPOLOGY_CONNECTION * const NewTopologyConnections
);

Parameters

[in] Filter

A pointer to the KSFILTER to which to add the new connections.

[in] NewConnectionsCount

The number of connections in NewTopologyConnections.

[in] NewTopologyConnections

A pointer to an array of KSTOPOLOGY_CONNECTION structures containing the new topology connections.

Return value

KsFilterAddTopologyConnections returns STATUS_SUCCESS or an error code indicating failure of the attempt to add topology connections.

Remarks

Note that the filter control mutex must be held before calling this function.

For more information about mutexes, see Mutexes in AVStream.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Universal
Header ks.h (include Ks.h)
Library Ks.lib
IRQL PASSIVE_LEVEL

See also

KSFILTER

KSTOPOLOGY_CONNECTION