KsGetParent-Funktion (ks.h)

Artikel
02/26/2024

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