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


Интерфейс 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)

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

IDispatch