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

Метод IReferenceClock::AdviseTime

  • Статья

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

Метод AdviseTime запрашивает асинхронное уведомление об истечении времени.

Синтаксис

HRESULT AdviseTime(
  [in]  REFERENCE_TIME rtBaseTime,
  [in]  REFERENCE_TIME rtStreamTime,
  [in]  HEVENT         hEvent,
  [out] DWORD          *pdwAdviseCookie
);

Параметры

rtBaseTime [in]

Базовое эталонное время в 100-наносекундных единицах.

rtStreamTime [in]

Время смещения потока в 100-наносекундных единицах.

hEvent [in]

Дескриптор события, созданного вызывающим. Это событие будет сигнализировать по истечении указанного времени.

pdwAdviseCookie [out]

Указатель на переменную, получающую идентификатор запроса. Он используется для идентификации этого вызова в AdviseTime в будущем, например для отмены запроса.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_POINTER
 Параметр pdwAdviseCookie имеет значение NULL.
E_FAIL
 Неуказанным сбоем.

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

Интерфейс IReferenceClock