KsGetNextSibling-Funktion (ks.h)

Artikel
02/26/2024

Die KsGetNextSibling-Funktion gibt das nächste gleichgeordnete Element eines bestimmten Objekts zurück.

Syntax

KSDDKAPI PVOID KsGetNextSibling(
  [in] PVOID Object
);

Parameter

[in] Object

Das Objekt, für das das nächste gleichgeordnete Element gefunden werden soll.

Rückgabewert

KsGetNextSibling gibt das nächste gleichgeordnete Objekt von Object zurück. Wenn kein solches gleichgeordnetes Objekt vorhanden ist, wird NULL zurückgegeben.

Hinweise

Wenn Object eine Filterfactory ist, gibt KsGetNextSibling die nächste Filterfactory zurück, die zum übergeordneten Gerät gehört usw. Aufrufer müssen eine geeignete Typecasting zu und von PVOID durchführen.

Die Objekthierarchie ist nur dann stabil, wenn der entsprechende Mutex gehalten wird, in diesem Fall der Gerätemutex. Weitere Informationen finden Sie unter Übersicht über AVStream und Mutexes in AVStream.

Minidriver rufen KsGetNextSibling selten direkt auf. Es gibt eine Reihe von Funktionen, die Inlineaufrufe an KsGetNextSibling sind und die die Typecasting für Sie ausführen: KsFilterFactoryGetNextSiblingFilterFactory, KsFilterGetNextSiblingFilter und KsPinGetNextSiblingPin.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen.
Zielplattform	Universell
Header	ks.h (ks.h einschließen)
Bibliothek	Ks.lib
IRQL	PASSIVE_LEVEL