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
KsFilterFactoryGetParentDevice