IAMTimelineComp：：VTrackInsBefore 方法
[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
注意
[已被取代。 此 API 可能會從未來的 Windows 版本中移除。]
方法 VTrackInsBefore 會在指定優先權的組合中插入虛擬播放軌。
語法
HRESULT VTrackInsBefore(
IAMTimelineObj *pVirtualTrack,
long Priority
);
參數
-
pVirtualTrack
-
虛擬播放軌 之 IAMTimelineObj 介面的指標。
-
優先順序
-
要插入虛擬播放軌的優先順序，或 –1 在優先順序清單結尾插入虛擬播放軌。 優先順序清單會決定哪些剪輯是可見的。 如需詳細資訊，請參閱「備註」。
傳回值
傳回下列其中一個 HRESULT 值：
| 傳回碼 | 描述 |
|---|---|
|
成功。 |
|
無效引數。 |
|
物件不是虛擬追蹤。 |
備註
組合中的每個虛擬追蹤都有唯一的優先順序層級。 優先順序層級的範圍從 0 到 n - 1，其中 n 是組合中的虛擬播放軌數目。 對於視訊群組，虛擬播放軌會隱藏優先順序較低的任何虛擬播放軌，但播放軌空白或包含轉換的位置除外。 您可以將虛擬播放軌視為最終組合中的圖層。 追蹤 1 會分層在追蹤 0 的頂端，追蹤 2 會分層在追蹤 1 之上，依此類推。
如果您為 Priority 參數指定 -1，虛擬播放軌會插入清單結尾，且優先順序值高於現有曲目。 如果您指定已存在於組合中的優先順序值，則每個優先順序相等或更高優先順序的追蹤都會向上移動一個優先順序層級。
範例：追蹤 A 的優先順序為 0，而追蹤 B 的優先順序為 1。 如果追蹤 C 插入優先順序為 0，追蹤 A 會移至優先順序 1，而追蹤 B 會移至優先順序 2。
如果指定的優先順序大於組合中的目前曲目數目，則方法會失敗。
注意
標頭檔 Qedit.h 與 7 版之後的 Direct3D 標頭不相容。
注意
若要取得 Qedit.h，請下載適用于 Windows Vista 的 Microsoft Windows SDK Update 和 .NET Framework 3.0。 Windows 7 和 .NET Framework 3.5 Service Pack 1 Microsoft Windows SDK中無法使用 Qedit.h。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|
另請參閱