Función KsGetFirstChild (ks.h)

La función KsGetFirstChild devuelve el primer objeto secundario AVStream de Object.

Sintaxis

KSDDKAPI PVOID KsGetFirstChild(
  [in] PVOID Object
);

Parámetros

[in] Object

Objeto para el que se va a buscar el primer objeto secundario AVStream.

Valor devuelto

KsGetFirstChild devuelve el primer objeto secundario AVStream de Object. Si no existe este objeto secundario, devuelve NULL.

Comentarios

Para ver la organización jerárquica de objetos AVStream, consulte Jerarquía de objetos AVStream.

Los minidrivers rara vez llaman directamente a esta función. Aquellos que sí deben realizar manualmente conversiones de tipos hacia y desde PVOID. Hay varias funciones que son llamadas insertadas a KsGetFirstChild y realizan conversiones de tipos por usted: KsDeviceGetFirstChildFilterFactory y KsFilterFactoryGetFirstChildFilter. Tenga en cuenta que 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.

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

KsDeviceGetFirstChildFilterFactory

KsFilterFactoryGetFirstChildFilter

KsFilterGetFirstChildPin

KsGetParent