Compartir a través de


Función KsGetParent (ks.h)

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

Consulte también

KSDEVICE

KSFILTER

KSFILTERFACTORY

KSPIN

KsFilterFactoryGetParentDevice

KsFilterGetParentFilterFactory

KsPinGetParentFilter