Метод IMediaDet::GetSampleGrabber
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Примечание
[Не рекомендуется. Этот API может быть удален из будущих выпусков Windows.]
Метод GetSampleGrabber извлекает указатель на интерфейс ISampleGrabber , который позволяет приложению извлекать отдельные примеры из потока мультимедиа.
Синтаксис
HRESULT GetSampleGrabber(
[out] ISampleGrabber **ppVal
);
Параметры
-
ppVal [out]
-
Получает указатель на интерфейс ISampleGrabber .
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Вызовите метод IMediaDet::EnterBitmapGrabMode перед вызовом этого метода. Интерфейс ISampleGrabber позволяет извлекать отдельные примеры мультимедиа из потока. Если вам просто требуется растровое изображение из видеокадра, вызовите вместо него метод IMediaDet::GetBitmapBits . Интерфейс ISampleGrabber является более гибким, но требует больше работы со стороны приложения.
Если этот метод завершается успешно, интерфейс ISampleGrabber , который он возвращает, имеет незавершенное число ссылок. После завершения работы с интерфейсом обязательно отпустите его.
Примечание
Файл заголовка 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).
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел