Функция KsGetNextSibling (ks.h)
Функция KsGetNextSibling возвращает следующий одноуровневый элемент заданного объекта.
Синтаксис
KSDDKAPI PVOID KsGetNextSibling(
[in] PVOID Object
);
Параметры
[in] Object
Объект , для которого требуется найти следующего одноуровневого элемента.
Возвращаемое значение
KsGetNextSibling возвращает следующий одноуровневый объект Object. Если такого одноуровневого объекта не существует, возвращается значение NULL.
Комментарии
Если Object является фабрикой фильтров, KsGetNextSibling возвращает следующую фабрику фильтров, принадлежащая родительскому устройству, и т. д. Вызывающие операторы должны выполнять соответствующее преобразование типов в PVOID и из нее.
Иерархия объектов гарантируется стабильной только при удержании соответствующего мьютекса, в данном случае мьютекса устройства. Дополнительные сведения см. в статье Обзор AVStream и мьютексы в AVStream.
Мини-накопители редко вызывают KsGetNextSibling напрямую. Существует ряд функций, которые являются встроенными вызовами KsGetNextSibling и выполняют за вас рассылку типов: KsFilterFactoryGetNextSiblingFilterFactory, KsFilterGetNextSiblingFilter и KsPinGetNextSiblingPin.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в операционных системах Microsoft Windows XP и более поздних версиях, а также DirectX 8.0 и более поздних версиях. |
| Целевая платформа | Универсальное |
| Верхняя часть | ks.h (включая Ks.h) |
| Библиотека | Ks.lib |
| IRQL | PASSIVE_LEVEL |