Метод IReferenceClockTimerControl::SetDefaultTimerResolution (strmif.h)

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

Метод SetDefaultTimerResolution задает минимальное разрешение таймера.

Синтаксис

HRESULT SetDefaultTimerResolution(
  [in] REFERENCE_TIME timerResolution
);

Параметры

[in] timerResolution

Минимальное разрешение таймера в единицах 100 наносекунд. Если значение равно нулю, ссылочные часы отменяют предыдущий запрос.

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата	Описание
S_OK	Успешно.

Комментарии

Эталонные часы пытаются задать для таймера период timerResolution. Фактический период таймера может отличаться в зависимости от оборудования. Чтобы найти минимальное и максимальное разрешение таймера, вызовите функцию timeGetDevCaps . Эталонные часы задают разрешение таймера путем вызова timeBeginPeriod. Если значение timerResolution равно 0, метод отменяет предыдущий запрос таймера, вызывая timeEndPeriod. (При уничтожении ссылочных часов все предыдущие запросы автоматически отменяются.)

Если этот метод не вызывается, ссылочные часы устанавливают разрешение таймера в 1 миллисекунды. Чтобы получить наилучшую производительность управления питанием, рекомендуется вызывать этот метод со значением 0. Это переопределяет значение по умолчанию часов в 1 миллисекунда. Если для фильтров в графе требуется более высокое разрешение таймера, они могут вызывать timeBeginPeriod по отдельности . Как правило, только отрисовщики должны требовать определенного разрешения таймера.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

Коды ошибок и успешности

Интерфейс IReferenceClockTimerControl