KsGetNextSibling, fonction (ks.h)
La fonction KsGetNextSibling retourne le frère suivant d’un objet donné.
Syntaxe
KSDDKAPI PVOID KsGetNextSibling(
[in] PVOID Object
);
Paramètres
[in] Object
Objet pour lequel trouver le frère suivant.
Valeur retournée
KsGetNextSibling retourne l’objet frère suivant de Object. S’il n’existe aucun objet frère de ce type, il retourne NULL.
Remarques
Si Object est une fabrique de filtres, KsGetNextSibling retourne la fabrique de filtre suivante appartenant à l’appareil parent, et ainsi de suite. Les appelants doivent effectuer une diffusion de type appropriée vers et depuis PVOID.
La hiérarchie d’objets est garantie stable uniquement pendant que le mutex approprié est maintenu, dans ce cas, le mutex de l’appareil. Pour plus d’informations, consultez Vue d’ensemble d’AVStream et Mutex dans AVStream.
Les minidrivers appellent rarement KsGetNextSibling directement. Il existe un certain nombre de fonctions qui sont des appels inline à KsGetNextSibling et qui effectuent la diffusion de type pour vous : KsFilterFactoryGetNextSiblingFilterFactory, KsFilterGetNextSiblingFilter et KsPinGetNextSiblingPin.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |