Интерфейс IBasicVideo (control.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]
Интерфейс IBasicVideo задает свойства видео, такие как прямоугольники назначения и источника. Фильтр Видео отрисовщика и Фильтры отрисовщика для микширования видео реализуют этот интерфейс, но интерфейс предоставляется приложениям через диспетчер фильтров графов. Приложения всегда должны получать этот интерфейс из диспетчера фильтров Graph.
Интерфейс IBasicVideo управляет следующими прямоугольниками, связанными с видеоизуком:
- Исходный прямоугольник — это часть исходного изображения, которая отображается.
- Прямоугольник назначения — это часть окна видео, получающего исходный прямоугольник.
- Прямоугольник видео — это исходное видео.
Свойства, заданные в отрисовщике видео, сохраняются между последовательными подключениями и отключениями.
Коды ошибок. Если фильтр отрисовщика видео не подключен к другому фильтру, все методы возвращают код ошибки VFW_E_NOT_CONNECTED. Для реализации диспетчера фильтров графов, если граф не содержит фильтр отрисовщика видео, все методы возвращают E_NOINTERFACE. Обратите внимание, что диспетчер фильтров графов предоставляет интерфейс, даже если граф не содержит отрисовщик видео, поэтому приложение может запросить интерфейс перед построением графа.
Наследование
Интерфейс IBasicVideo наследуется от интерфейса IDispatch . IBasicVideo также имеет следующие типы членов:
Методы
Интерфейс IBasicVideo содержит следующие методы.
| IBasicVideo::get_AvgTimePerFrame Метод get_AvgTimePerFrame извлекает среднее время между последовательными кадрами. |
| IBasicVideo::get_BitErrorRate Метод get_BitErrorRate извлекает приблизительную скорость битовых ошибок видеопотока. |
| IBasicVideo::get_BitRate Метод get_BitRate извлекает приблизительную скорость потока видео. |
| IBasicVideo::get_DestinationHeight Метод get_DestinationHeight извлекает высоту прямоугольника назначения. |
| IBasicVideo::get_DestinationLeft Метод get_DestinationLeft извлекает координату X прямоугольника назначения. |
| IBasicVideo::get_DestinationTop Метод get_DestinationTop получает координату Y прямоугольника назначения. |
| IBasicVideo::get_DestinationWidth Метод get_DestinationWidth извлекает ширину прямоугольника назначения. |
| IBasicVideo::get_SourceHeight Метод get_SourceHeight извлекает высоту исходного прямоугольника. |
| IBasicVideo::get_SourceLeft Метод get_SourceLeft извлекает координату X исходного прямоугольника. |
| IBasicVideo::get_SourceTop Метод get_SourceTop извлекает координату Y исходного прямоугольника. |
| IBasicVideo::get_SourceWidth Метод get_SourceWidth извлекает ширину исходного прямоугольника. |
| IBasicVideo::get_VideoHeight Метод get_VideoHeight извлекает собственную высоту видео. |
| IBasicVideo::get_VideoWidth Метод get_VideoWidth извлекает собственную ширину видео. |
| IBasicVideo::GetCurrentImage Метод GetCurrentImage извлекает текущее изображение, ожидающего в отрисовщике. |
| IBasicVideo::GetDestinationPosition Метод GetDestinationPosition извлекает положение прямоугольника назначения. |
| IBasicVideo::GetSourcePosition Метод GetSourcePosition извлекает положение исходного прямоугольника. |
| IBasicVideo::GetVideoPaletteEntries Метод GetVideoPaletteEntries извлекает цвета палитры для видео. |
| IBasicVideo::GetVideoSize Метод GetVideoSize извлекает собственные измерения видео. |
| IBasicVideo::IsUsingDefaultDestination Метод IsUsingDefaultDestination запрашивает, использует ли отрисовщик прямоугольник назначения по умолчанию. |
| IBasicVideo::IsUsingDefaultSource Метод IsUsingDefaultSource запрашивает, использует ли отрисовщик исходный прямоугольник по умолчанию. |
| IBasicVideo::p ut_DestinationHeight Метод put_DestinationHeight задает высоту прямоугольника назначения. |
| IBasicVideo::p ut_DestinationLeft Метод put_DestinationLeft задает координату X прямоугольника назначения. |
| IBasicVideo::p ut_DestinationTop Метод put_DestinationTop задает координату Y прямоугольника назначения. |
| IBasicVideo::p ut_DestinationWidth Метод put_DestinationWidth задает ширину прямоугольника назначения. |
| IBasicVideo::p ut_SourceHeight Метод put_SourceHeight задает высоту исходного прямоугольника. |
| IBasicVideo::p ut_SourceLeft Метод put_SourceLeft задает координату X исходного прямоугольника. |
| IBasicVideo::p ut_SourceTop Метод put_SourceTop задает координату Y исходного прямоугольника. |
| IBasicVideo::p ut_SourceWidth Метод put_SourceWidth задает ширину исходного прямоугольника. |
| IBasicVideo::SetDefaultDestinationPosition Метод SetDefaultDestinationPosition возвращается к прямоугольнику назначения по умолчанию. После вызова этого метода отрисовщик видео использует для воспроизведения все окно. |
| IBasicVideo::SetDefaultSourcePosition Метод SetDefaultSourcePosition возвращается к исходному прямоугольнику по умолчанию. После вызова этого метода отрисовщик видео использует все изображение видео без обрезки. |
| IBasicVideo::SetDestinationPosition Метод SetDestinationPosition задает прямоугольник назначения. |
| IBasicVideo::SetSourcePosition Метод SetSourcePosition задает исходный прямоугольник. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | control.h (включая Dshow.h) |