KsFilterFactoryGetFirstChildFilter function

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

Syntax


PKSFILTER __inline KsFilterFactoryGetFirstChildFilter(
  _In_ PKSFILTERFACTORY FilterFactory
);

Parameters

FilterFactory [in]

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

Target platform

Desktop

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

IRQL

PASSIVE_LEVEL

See also

KSFILTER
KSFILTERFACTORY
KsGetFirstChild
KsFilterGetNextSiblingFilter

 

 

Send comments about this topic to Microsoft

Show: