KsFilterFactoryGetFirstChildFilter function (ks.h)
The KsFilterFactoryGetFirstChildFilter function returns the first instantiated filter created by FilterFactory.
Syntax
PKSFILTER KsFilterFactoryGetFirstChildFilter(
[in] PKSFILTERFACTORY FilterFactory
);
Parameters
[in] FilterFactory
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
| 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 |