Método IAMTimelineComp::VTrackInsBefore

[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 VTrackInsBefore método inserta una pista virtual en la composición con la prioridad especificada.

Sintaxis

HRESULT VTrackInsBefore(
   IAMTimelineObj *pVirtualTrack,
   long           Priority
);

Parámetros

pVirtualTrack

Puntero a la interfaz IAMTimelineObj de la pista virtual.

Prioridad

Prioridad en la que se va a insertar la pista virtual o –1 para insertar la pista virtual al final de la lista de prioridades. La lista de prioridades determina qué clips están visibles. Vea Comentarios para obtener más información.

Valor devuelto

Devuelve uno de los siguientes valores HRESULT :

Código devuelto	Descripción
S_OK	Correcto.
E_INVALIDARG	Argumento no válido.
E_NOINTERFACE	El objeto no es una pista virtual.

 

Observaciones

Cada pista virtual en composición tiene un nivel de prioridad único. Los niveles de prioridad oscilan entre 0 y n - 1, donde n es el número de pistas virtuales en la composición. En el caso de los grupos de vídeo, una pista virtual oculta las pistas virtuales con un nivel de prioridad inferior, excepto en lugares donde la pista está vacía o contiene una transición. Puede considerar las pistas virtuales como capas en la composición final. La pista 1 está superpuesta sobre la pista 0, la pista 2 está superpuesta sobre la pista 1, etc.

Si especifica -1 para el parámetro Priority , la pista virtual se inserta al final de la lista, con un valor de prioridad mayor que las pistas existentes. Si especifica un valor de prioridad que ya existe en la composición, cada pista con una prioridad igual o mayor se mueve hacia arriba un nivel de prioridad.

Ejemplo: El seguimiento A tiene prioridad 0 y el seguimiento B tiene prioridad 1. Si el seguimiento C se inserta en la prioridad 0, el seguimiento A pasa a la prioridad 1 y el seguimiento B se mueve a la prioridad 2.

Si la prioridad especificada es mayor que el número actual de pistas en la composición, se produce un error en el método.

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