Función KsGetNextSibling (ks.h)

Artículo
02/26/2024

La función KsGetNextSibling devuelve el siguiente elemento relacionado de un objeto determinado.

Sintaxis

KSDDKAPI PVOID KsGetNextSibling(
  [in] PVOID Object
);

Parámetros

[in] Object

Objeto para el que se va a buscar el siguiente elemento del mismo nivel.

Valor devuelto

KsGetNextSibling devuelve el siguiente objeto relacionado de Object. Si no existe este objeto relacionado, devuelve NULL.

Comentarios

Si Object es un generador de filtros, KsGetNextSibling devuelve la siguiente fábrica de filtros que pertenece al dispositivo primario, etc. Los autores de llamadas deben realizar la difusión de tipos adecuada hacia y desde PVOID.

La jerarquía de objetos solo se garantiza estable mientras se mantiene la exclusión mutua adecuada, en este caso, la exclusión mutua del dispositivo. Para obtener más información, vea Información general y exclusión mutua de AVStream en AVStream.

Los minidrivers rara vez llaman directamente a KsGetNextSibling . Hay varias funciones que son llamadas insertadas a KsGetNextSibling y que realizan la difusión de tipos automáticamente: KsFilterFactoryGetNextSiblingFilterFactory, KsFilterGetNextSiblingFilter y KsPinGetNextSiblingPin.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows XP y en sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
Plataforma de destino	Universal
Encabezado	ks.h (incluye Ks.h)
Library	Ks.lib
IRQL	PASSIVE_LEVEL