Metodo IAMTimelineComp::VTrackInsBefore
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Nota
[Deprecata. Questa API può essere rimossa dalle versioni future di Windows.]
Il VTrackInsBefore metodo inserisce una traccia virtuale nella composizione con la priorità specificata.
Sintassi
HRESULT VTrackInsBefore(
IAMTimelineObj *pVirtualTrack,
long Priority
);
Parametri
-
pVirtualTrack
-
Puntatore all'interfaccia IAMTimelineObj della traccia virtuale.
-
Priorità
-
Priorità in base alla quale inserire la traccia virtuale oppure –1 per inserire la traccia virtuale alla fine dell'elenco di priorità. L'elenco di priorità determina quali clip sono visibili. Per ulteriori informazioni, vedere la sezione Osservazioni.
Valore restituito
Restituisce uno dei valori HRESULT seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Argomento non valido. |
|
L'oggetto non è una traccia virtuale. |
Commenti
Ogni traccia virtuale in composizione ha un livello di priorità univoco. I livelli di priorità vanno da 0 a n - 1, dove n è il numero di tracce virtuali nella composizione. Per i gruppi di video, una traccia virtuale nasconde le tracce virtuali con un livello di priorità inferiore, ad eccezione delle posizioni in cui la traccia è vuota o contiene una transizione. È possibile pensare a tracce virtuali come livelli nella composizione finale. La traccia 1 viene stratiata sulla parte superiore della traccia 0, la traccia 2 viene stratiata sulla parte superiore della traccia 1 e così via.
Se si specifica -1 per il parametro Priority , la traccia virtuale viene inserita alla fine dell'elenco, con un valore di priorità superiore rispetto alle tracce esistenti. Se si specifica un valore di priorità già presente nella composizione, ogni traccia con una priorità uguale o maggiore sposta un livello di priorità superiore.
Esempio: Track A ha priorità 0 e track B ha priorità 1. Se la traccia C viene inserita con priorità 0, tenere traccia di A spostarsi sulla priorità 1 e tenere traccia del movimento B sulla priorità 2.
Se la priorità specificata è maggiore del numero corrente di tracce nella composizione, il metodo ha esito negativo.
Nota
Il file di intestazione Qedit.h non è compatibile con intestazioni Direct3D successive alla versione 7.
Nota
Per ottenere Qedit.h, scaricare l'aggiornamento Microsoft Windows SDK per Windows Vista e .NET Framework 3.0. Qedit.h non è disponibile nella Microsoft Windows SDK per Windows 7 e .NET Framework 3.5 Service Pack 1.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche