Поделиться через

Метод IPropertySetter::CloneProps

  • Статья

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Примечание

[Не рекомендуется. Этот API можно удалить из будущих выпусков Windows.]

 

Метод CloneProps клонирует набор свойств из этого метода задания свойств и добавляет их в новый метод задания свойств.

Синтаксис

HRESULT CloneProps(
  [out] IPropertySetter **ppSetter,
  [in]  REFERENCE_TIME  rtStart,
  [in]  REFERENCE_TIME  rtStop
);

Параметры

ppSetter [out]

Получает указатель на интерфейс IPropertySetter нового метода задания свойств.

rtStart [in]

Время начала диапазона значений для клонирования в 100-наносекундных единицах.

rtStop [in]

Зарезервировано.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Клонируются только значения, которые падают после указанного времени начала. Время клонированных значений затем корректируется относительно времени начала. Например, если rtStart имеет значение 20000000 (2 секунды), то значение в момент времени 30000000 (3 секунды) клонируется с временем 100000000 (1 секунда). Наконец, каждому клонированному свойству присваивается начальное значение, равное значению исходного свойства во время запуска (при необходимости правильно интерполируется). Фактически данные свойства разделяются в указанное время начала.

Если метод выполнен успешно, интерфейс IPropertySetter , который он возвращает, имеет неоплаченное число ссылок. Не забудьте освободить интерфейс после завершения его использования.

Примечание

Файл заголовка 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).

 

Требования

Требование Значение
Заголовок
Qedit.h
Библиотека
Strmiids.lib

См. также раздел

Интерфейс IPropertySetter

Коды ошибок и успешного выполнения