KsFilterFactoryGetFirstChildFilter function (ks.h)

The KsFilterFactoryGetFirstChildFilter function returns the first instantiated filter created by FilterFactory.

Syntax

PKSFILTER KsFilterFactoryGetFirstChildFilter(
  [in] PKSFILTERFACTORY FilterFactory
);

Parameters

[in] FilterFactory

A pointer to the KSFILTERFACTORY structure for which to find the first instantiated child filter.

Return value

KsFilterFactoryGetFirstChildFilter returns a pointer to the first instantiated KSFILTER structure created by FilterFactory. If there are no instantiated filters created by FilterFactory, NULL is returned.

Remarks

This call is an inline function call to KsGetFirstChild. Note that the object hierarchy is guaranteed to be stable only while the appropriate mutex is held, in this case the device mutex. For more information, 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 Desktop
Header ks.h (include Ks.h)
IRQL PASSIVE_LEVEL

See also

KSFILTER

KSFILTERFACTORY

KsFilterGetNextSiblingFilter

KsGetFirstChild