Expand Minimize

KsDeviceGetFirstChildFilterFactory function

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

Syntax


PKSFILTERFACTORY __inline KsDeviceGetFirstChildFilterFactory(
  _In_  PKSDEVICE 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.

Requirements

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

KSDEVICE
KSFILTERFACTORY
KsGetFirstChild
KsFilterFactoryGetNextSiblingFilterFactory

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft