Función KsGetParent (ks.h)

Artículo
02/26/2024

La función KsGetParent adquiere el elemento primario del objeto especificado.

Sintaxis

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

Parámetros

[in] Object

Puntero al objeto AVStream para el que se va a buscar el elemento primario. Debe ser un puntero a uno de los siguientes tipos: KSDEVICE, KSFILTERFACTORY, KSFILTER o KSPIN. Los autores de llamadas deben escribir manualmente el objeto en un PVOID.

Valor devuelto

KsGetParent devuelve el elemento primario de Object como UN PVOID. Los autores de llamadas deben convertir manualmente este valor devuelto en cualquier tipo del elemento primario de Object .

Comentarios

Para obtener una representación gráfica de las relaciones de elementos primarios y secundarios de AVStream, consulte el diagrama de la jerarquía de objetos avStream.

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, consulte Exclusión mutua en AVStream.

Los minidrivers rara vez usan esta función directamente. Los autores de llamadas de KsGetParent deben realizar manualmente conversiones de tipos hacia y desde PVOID. Hay una serie de versiones insertadas que realizan la conversión automáticamente: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactory y KsPinGetParentFilterFilter.

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