KsGetNextSibling-Funktion (ks.h)
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 |