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