KsGetParent-Funktion (ks.h)
Die KsGetParent-Funktion ruft das übergeordnete Objekt des angegebenen Objekts ab.
Syntax
KSDDKAPI PVOID KsGetParent(
[in] PVOID Object
);
Parameter
[in] Object
Ein Zeiger auf das AVStream-Objekt, für das das übergeordnete Objekt gefunden werden soll. Muss ein Zeiger auf einen der folgenden Typen sein: KSDEVICE, KSFILTERFACTORY, KSFILTER oder KSPIN. Aufrufer müssen das Objekt manuell in eine PVOID-Datei eingeben.
Rückgabewert
KsGetParent gibt das übergeordnete Element von Object als PVOID zurück. Aufrufer müssen diesen Rückgabewert manuell in den Typ des übergeordneten Objekts umwandeln.
Hinweise
Eine grafische Darstellung der beziehungen zwischen übergeordneten und untergeordneten AVStream-Elementen finden Sie im Diagramm in AVStream-Objekthierarchie.
Die Objekthierarchie ist nur dann stabil, wenn der entsprechende Mutex gehalten wird, in diesem Fall das Gerätemutex. Weitere Informationen finden Sie unter Mutexes in AVStream.
Minidriver verwenden diese Funktion selten direkt. Aufrufer von KsGetParent müssen Typecasts von und zu PVOID manuell ausführen. Es gibt eine Reihe von Inlineversionen, die die Umwandlung für Sie durchführen: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactory und KsPinGetParentFilter.
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
KsFilterFactoryGetParentDevice