// ks.h
KSDDKAPI PVOID KsGetFirstChild(
[in] PVOID Object
);
View the official Windows Driver Kit DDI referenceNo description available.
The KsGetFirstChild function returns the first AVStream child object of Object.
Object [in]The object for which to find the first AVStream child object.
KsGetFirstChild returns the first AVStream child object of Object. If no such child object exists, it returns NULL.
To see the hierarchical organization of AVStream objects, see AVStream Object Hierarchy.
Minidrivers rarely call this function directly. Those that do must manually perform typecasts to and from PVOID. There are a number of functions that are inline calls to KsGetFirstChild and perform typecasts for you: KsDeviceGetFirstChildFilterFactory and KsFilterFactoryGetFirstChildFilter. 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.
KsDeviceGetFirstChildFilterFactory
KsFilterFactoryGetFirstChildFilter