KsGetFirstChild-Funktion (ks.h)
Die funktion KsGetFirstChild gibt das erste untergeordnete AVStream-Objekt Objectzurück.
Syntax
KSDDKAPI PVOID KsGetFirstChild(
[in] PVOID Object
);
Parameter
[in] Object
Das Objekt, für das das erste untergeordnete AVStream-Objekt gesucht werden soll.
Rückgabewert
KsGetFirstChild gibt das erste untergeordnete AVStream-Objekt Objectzurück. Wenn kein solches untergeordnetes Objekt vorhanden ist, wird NULL-zurückgegeben.
Bemerkungen
Informationen zur hierarchischen Organisation von AVStream-Objekten finden Sie unter AVStream-Objekthierarchie.
Minidriver rufen diese Funktion selten direkt auf. Diejenigen, die Typecasts manuell an und von PVOID ausführen müssen. Es gibt eine Reihe von Funktionen, die Inlineaufrufe an KsGetFirstChild sind und Typecasts für Sie ausführen: KsDeviceGetFirstChildFilterFactory und KsFilterFactoryGetFirstChildFilter. Beachten Sie, dass die Objekthierarchie nur stabil ist, während das entsprechende Mutex gehalten wird, in diesem Fall das Gerätemutex. Weitere Informationen finden Sie unter Mutexes in AVStream.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | PASSIVE_LEVEL |
Siehe auch
KsDeviceGetFirstChildFilterFactory