Метод CAMSchedule.AddAdvisePacket

Статья
07/28/2023

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

Метод AddAdvisePacket добавляет запрос на получение рекомендаций в список ожидающих запросов.

Синтаксис

DWORD_PTR AddAdvisePacket(
  [ref] const REFERENCE_TIME &time1,
  [ref] const REFERENCE_TIME &time2,
              HANDLE         hNotify,
              BOOL           bPeriodic
);

Параметры

time1 [ссылка]: Запрошено время для рекомендации.
time2 [ссылка]: Для периодических запросов рекомендаций — время между уведомлениями. Этот параметр игнорируется, если параметр bPeriodic имеет значение FALSE.
hNotify: Обработка семафора, если bPeriodic имеет значение TRUE, или обработка события, если bPeriodic имеет значение FALSE.
bПериодический: Логическое значение, указывающее, следует ли добавлять периодическое или однократное уведомление. Если задано значение TRUE, уведомление является периодическим; параметр time2 указывает время между уведомлениями. Если значение РАВНО FALSE, уведомление отправляется только один раз.

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

Возвращает идентификатор для запроса на получение рекомендаций ("файл cookie"). Если метод завершается ошибкой, возвращаемое значение равно нулю.

Требования

Требование	Значение
Заголовок	Dsschedule.h (включая Streams.h)
Библиотека	Strmbase.lib (розничные сборки); Strmbasd.lib (отладочные сборки)

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

Класс CAMSchedule

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