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

Метод IMediaDet::EnterBitmapGrabMode

  • Статья

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

Примечание

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

 

Метод EnterBitmapGrabMode переключает детектор мультимедиа в режим захвата растрового изображения и ищет график фильтра на указанное время.

Синтаксис

HRESULT EnterBitmapGrabMode(
   double StreamTime
);

Параметры

StreamTime

Время в секундах, к которому выполняется поиск графа.

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

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

Код возврата Описание
S_OK
 Успешно.
E_INVALIDARG
 Недопустимый аргумент.
VFW_E_INVALIDMEDIATYPE
 Исходный файл не содержит видеопотока.
VFW_E_TIME_EXPIRED
 Истекло время ожидания команды Seek.

 

Комментарии

Перед вызовом этого метода задайте имя файла и поток, вызвав IMediaDet::p ut_Filename и IMediaDet::p ut_CurrentStream.

Этот метод вставляет фильтр Sample Grabber в граф фильтра. Затем можно вызвать метод IMediaDet::GetSampleGrabber , чтобы получить указатель на интерфейс ISampleGrabber . После того как детектор мультимедиа перейдет в режим захвата растрового изображения, различные информационные методы в IMediaDet не работают.

Методы IMediaDet::GetBitmapBits или IMediaDet::WriteBitmapBits также переводят детектор мультимедиа в режим захвата точечных изображений.

Примечание

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

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

Интерфейс IMediaDet

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