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 |