KsFilterCreateNode function (ks.h)

The KsFilterCreateNode function creates a new topology node on the specified filter.

Syntax

KSDDKAPI NTSTATUS KsFilterCreateNode(
  [in]  PKSFILTER                       Filter,
  [in]  const KSNODE_DESCRIPTOR * const NodeDescriptor,
  [out] PULONG                          NodeID
);

Parameters

[in] Filter

A pointer to a KSFILTER structure on which to create a new topology node.

[in] NodeDescriptor

A pointer to a KSNODE_DESCRIPTOR structure that describes the new node.

[out] NodeID

A pointer to a ULONG where AVStream places the ID of the new node.

Return value

KsFilterCreateNode returns the success or failure of creating the node. The call may fail because of invalid parameters, low memory, or other reasons.

Remarks

Note that the filter control mutex must be held before calling this function. For more information, see Filter Control Mutex in AVStream.

Requirements

Requirement Value
Target Platform Universal
Header ks.h
Library Ks.lib
IRQL PASSIVE_LEVEL

See also

KsFilterCreatePinFactory