KsGetFirstChild-Funktion (ks.h)
Die KsGetFirstChild-Funktion gibt das erste untergeordnete AVStream-Objekt von Object zurück.
Syntax
KSDDKAPI PVOID KsGetFirstChild(
[in] PVOID Object
);
Parameter
[in] Object
Das Objekt, für das das erste untergeordnete AVStream-Objekt gefunden werden soll.
Rückgabewert
KsGetFirstChild gibt das erste untergeordnete AVStream-Objekt von Object zurück. Wenn kein solches untergeordnetes Objekt vorhanden ist, wird NULL zurückgegeben.
Hinweise
Informationen zum hierarchischen organization von AVStream-Objekten finden Sie unter AVStream-Objekthierarchie.
Minidriver rufen diese Funktion selten direkt auf. Diejenigen, die dies tun, müssen Typecasts manuell zu und von PVOID ausführen. Es gibt eine Reihe von Funktionen, die Inlineaufrufe von KsGetFirstChild sind und Typecasts für Sie ausführen: KsDeviceGetFirstChildFilterFactory und KsFilterFactoryGetFirstChildFilter. Beachten Sie, dass die Objekthierarchie nur dann stabil ist, wenn der entsprechende Mutex gehalten wird, in diesem Fall das Gerätemutex. Weitere Informationen finden Sie unter Mutexes in AVStream.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Weitere Informationen
KsDeviceGetFirstChildFilterFactory