Метод IVMRSurfaceAllocatorNotify::NotifyEvent (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Метод NotifyEvent вызывается allocator-presenter для информирования VMR о любых важных событиях DirectShow во время процессов выделения или представления.
Синтаксис
HRESULT NotifyEvent(
[in] LONG EventCode,
[in] LONG_PTR Param1,
[in] LONG_PTR Param2
);
Параметры
[in] EventCode
Указывает код события.
[in] Param1
Указывает Param1 кода события.
[in] Param2
Указывает Param2 кода события.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
VMR предоставляет allocator-presenter с указателем на этот интерфейс в вызове IVMRSurfaceAllocator::AdviseNotify. Когда allocator-presenter вызывает этот метод и указывает некоторое регулярное событие DirectShow, например EC_ERRORABORT или EC_VMR_RENDERDEVICE_SET, VMR передает событие диспетчеру графов фильтров.
Требования
| Минимальная версия клиента | Windows XP с пакетом обновления 1 (SP1) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |