KsFilterFactoryGetSymbolicLink function (ks.h)

The KsFilterFactoryGetSymbolicLink function returns the symbolic link associated with a given filter factory.

Syntax

KSDDKAPI PUNICODE_STRING KsFilterFactoryGetSymbolicLink(
  [in] PKSFILTERFACTORY FilterFactory
);

Parameters

[in] FilterFactory

A pointer to a KSFILTERFACTORY structure for which to acquire the symbolic link.

Return value

KsFilterFactoryGetSymbolicLink returns a pointer to a Unicode string containing the symbolic link for the filter factory if the call is successful, and NULL if unsuccessful. NULL indicates that no device interfaces have been registered for FilterFactory.

Remarks

If FilterFactory has no registered device interfaces, KsFilterFactoryGetSymbolicLink returns NULL.

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