KsDeviceGetFirstChildFilterFactory - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// ks.h

PKSFILTERFACTORY KsDeviceGetFirstChildFilterFactory(
  [in] PKSDEVICE Device
);
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nf-ks-ksdevicegetfirstchildfilterfactory)

KsDeviceGetFirstChildFilterFactory function

Description

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

Parameters

Device [in]

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.

See also

KSDEVICE

KSFILTERFACTORY

KsFilterFactoryGetNextSiblingFilterFactory

KsGetFirstChild