Método IAMTimelineComp::GetRecursiveLayerOfType

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

Nota:

[Desusado. Esta API se puede quitar de futuras versiones de Windows.]

 

El GetRecursiveLayerOfType método realiza una ordenación detallada de las pistas virtuales contenidas en esta composición y recupera la nªpista virtual de esa ordenación.

Sintaxis

HRESULT GetRecursiveLayerOfType(
  [out] IAMTimelineObj      **ppVirtualTrack,
        long                WhichLayer,
        TIMELINE_MAJOR_TYPE Type
);

Parámetros

ppVirtualTrack [out]

Recibe un puntero a la interfaz IAMTimelineObj de la pista virtual.

WhichLayer

Especifica la pista virtual que se va a recuperar, indizada desde cero.

Tipo

Miembro del tipo enumerado TIMELINE_MAJOR_TYPE que especifica si se deben incluir pistas en la búsqueda.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT :

Código devuelto	Descripción
S_OK	Correcto.
E_INVALIDARG	No hay ningún objeto del tipo especificado.
E_POINTER	Argumento de puntero NULL.

 

Observaciones

Normalmente, una aplicación no necesitará llamar a este método.

Si el parámetro Type es TIMELINE_MAJOR_TYPE_TRACK, el orden detallado incluye pistas. Si no es así, solo incluye composiciones y grupos. El propio objeto se incluye en el orden.

Por ejemplo, en la siguiente disposición, a partir de composición A, la ordenación sería B, C, F, D, E, A.

Si el método se ejecuta correctamente, la interfaz IAMTimelineObj que devuelve tiene un recuento de referencias pendiente. Asegúrese de liberar la interfaz cuando haya terminado de usarla.

Nota:

El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.

 

Nota:

Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.

 

Requisitos

Requisito	Value
Encabezado	Qedit.h
Biblioteca	Strmiids.lib

Consulte también

IAMTimelineComp (interfaz)

Códigos de error y éxito