Метод IAMTimelineComp::VTrackInsBefore
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие 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 несовместим с заголовками Direct3D более поздней версии 7.
Примечание
Чтобы получить Qedit.h, скачайте обновление Microsoft Windows SDK для Windows Vista и платформа .NET Framework 3.0. Qedit.h недоступен в Microsoft Windows SDK для Windows 7 и платформа .NET Framework 3.5 с пакетом обновления 1 (SP1).
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел