KsDeviceGetFirstChildFilterFactory function (ks.h)

The KsDeviceGetFirstChildFilterFactory function returns the first child filter factory belonging to a given AVStream device.

Syntax

PKSFILTERFACTORY KsDeviceGetFirstChildFilterFactory(
  [in] PKSDEVICE Device
);

Parameters

[in] Device

A pointer to a KSDEVICE structure representing the AVStream device for which to find the first child filter factory.

Return value

Returns a pointer to a KSFILTERFACTORY structure representing the first child filter factory of Device. If there are no filter factories registered on Device, NULL is returned.

Remarks

This call is an inline function call to KsGetFirstChild. Note that the object hierarchy is only guaranteed stable while the appropriate mutex is held, in this case the device mutex. For more information, see Mutexes in AVStream.

For a graphical representation of AVStream parent/child relationships, see the diagram in AVStream Object Hierarchy.

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

KSDEVICE

KSFILTERFACTORY

KsFilterFactoryGetNextSiblingFilterFactory

KsGetFirstChild