Класс CBaseControlVideo
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Класс CBaseControlVideo реализует интерфейс IBasicVideo и управляет свойствами видео универсального окна видео. Как правило, объект CBaseControlVideo — это отрисовщик видео, который рисует видео в окне на дисплее.
Для многих функций-членов CBaseControlVideo требуется только подключение отрисовщика видео к графу фильтра. Если он не подключен, функции-члены возвращают VFW_E_NOT_CONNECTED. Свойства, заданные в отрисовщике видео, сохраняются между последовательными подключениями и отключениями. Перед началом презентации все приложения должны сбрасывать свойства отрисовщика.
При работе с видео приложение может выбрать часть видео для использования. Эта часть является исходным прямоугольником, которым управляет объект CBaseControlVideo . CBaseControlVideo позволяет приложению задавать и извлекать исходный прямоугольник. Все прямоугольники, которые использует CBaseControlVideo , используют значения ширины и высоты, а не правых и нижних значений. Если исходный прямоугольник не задан, свойства исходного прямоугольника возвращают полный собственный размер видео.
| Защищенные члены данных | Описание |
|---|---|
| m_pFilter | Указатель на фильтр носителей-владельцев. |
| m_pInterfaceLock | Критический раздел, определенный извне. |
| m_pPin | Управление типами носителей для подключения. |
| Функции элементов | Описание |
| CBaseControlVideo | Создает объект CBaseControlVideo . |
| CopyImage | Создает копию видеоизука в памяти. |
| GetImageSize | Извлекает сведения о размере видеоимнима. |
| SetControlVideoPin | Задает контакт, с которым должен синхронизироваться этот объект. |
| Переопределимые функции-члены | Описание |
| CheckSourceRect | Определяет, является ли исходный прямоугольник допустимым. |
| CheckTargetRect | Определяет, является ли целевой прямоугольник допустимым. |
| GetSourceRect | Извлекает текущий исходный прямоугольник видео (чистый виртуальный). |
| GetStaticImage | Возвращает текущее изображение в буфере памяти (чисто виртуальном). |
| GetTargetRect | Извлекает текущий целевой прямоугольник видео (чисто виртуальный). |
| GetVideoFormat | Извлекает структуру VIDEOINFOHEADER, содержащую формат видео. |
| IsDefaultSourceRect | Определяет, использует ли отрисовщик исходный прямоугольник по умолчанию (чистый виртуальный). |
| IsDefaultTargetRect | Определяет, использует ли отрисовщик целевой прямоугольник по умолчанию (чистый виртуальный). |
| OnUpdateRectangles | Вызывается при изменении исходного или целевого прямоугольника. |
| OnVideoSizeChange | Передает EC_VIDEO_SIZE_CHANGED приложению. |
| SetDefaultSourceRect | Задает прямоугольник исходного видео по умолчанию (чистый виртуальный). |
| SetDefaultTargetRect | Задает целевой прямоугольник видео по умолчанию (чистый виртуальный). |
| SetSourceRect | Задает текущий исходный прямоугольник видео (чистый виртуальный). |
| SetTargetRect | Задает текущий целевой прямоугольник (чистый виртуальный). |
| Методы IBasicVideo | Описание |
| get_AvgTimePerFrame | Извлекает приблизительное среднее время на кадр. |
| get_BitErrorRate | Извлекает приблизительную скорость ошибок в битах. |
| get_BitRate | Извлекает приблизительную скорость передачи видео. |
| GetCurrentImage | Извлекает отрисовку текущего изображения в памяти. |
| get_DestinationHeight | Извлекает высоту текущего целевого прямоугольника. |
| get_DestinationLeft | Извлекает левую координату текущего целевого прямоугольника. |
| GetDestinationPosition | Извлекает текущую целевую позицию. |
| get_DestinationTop | Извлекает верхнюю координату текущего целевого прямоугольника. |
| get_DestinationWidth | Извлекает ширину текущего целевого прямоугольника. |
| get_SourceHeight | Извлекает высоту текущего исходного прямоугольника. |
| get_SourceLeft | Извлекает левую координату текущего исходного прямоугольника. |
| GetSourcePosition | Извлекает текущую исходную позицию. |
| get_SourceTop | Извлекает верхнюю координату текущего исходного прямоугольника. |
| get_SourceWidth | Извлекает ширину текущего исходного прямоугольника. |
| get_VideoHeight | Извлекает собственную высоту видео. |
| GetVideoPaletteEntries | Извлекает диапазон записей палитры для видео. |
| GetVideoSize | Получает ширину и высоту собственного видео. |
| get_VideoWidth | Извлекает собственную ширину видео. |
| IsUsingDefaultDestination | Определяет, использует ли отрисовщик окно назначения по умолчанию. |
| IsUsingDefaultSource | Определяет, использует ли отрисовщик исходное окно по умолчанию. |
| put_DestinationHeight | Задает высоту прямоугольника назначения. |
| put_DestinationLeft | Задает левую координату прямоугольника назначения. |
| put_DestinationTop | Задает верхнюю координату прямоугольника назначения. |
| put_DestinationWidth | Задает ширину прямоугольника назначения. |
| put_SourceHeight | Задает высоту исходного прямоугольника. |
| put_SourceLeft | Задает левую координату исходного прямоугольника. |
| put_SourceTop | Задает верхнюю координату исходного прямоугольника. |
| put_SourceWidth | Задает ширину исходного прямоугольника. |
| SetDefaultDestinationPosition | Снова задает позицию назначения по умолчанию. |
| SetDefaultSourcePosition | Снова задает исходное положение по умолчанию. |
| SetDestinationPosition | Задает положение прямоугольника назначения. |
| SetSourcePosition | Задает положение исходного прямоугольника. |
См. также раздел