Метод CBaseControlWindow.GetMaxIdealImageSize

  • Статья

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

Метод GetMaxIdealImageSize извлекает максимальный идеальный размер изображения.

Синтаксис

HRESULT GetMaxIdealImageSize(
   long *pWidth,
   long *pHeight
);

Параметры

pWidth

Указатель на максимальную идеальную ширину в пикселях.

pHeight

Указатель на максимальную идеальную высоту в пикселях.

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

Возвращает значение HRESULT .

Комментарии

Различные отрисовщики имеют ограничения производительности на размер изображений, которые они могут отображать. Несмотря на то, что они по-прежнему должны правильно работать при появлении запроса на отображение изображений, превышающих указанное максимальное значение, отрисовщики могут назначать минимальные и максимальные идеальные размеры через интерфейс IVideoWindow . Этот интерфейс можно вызывать только при приостановке или выполнении графа фильтра, так как ресурсы выделяются только тогда, а отрисовщик может распознать его ограничения. Если ограничений нет, отрисовщик заполняет параметры pWidth и pHeight собственными измерениями видео и возвращает S_FALSE. Если ограничения существуют, вводится ограниченная ширина и высота, а функция-член возвращает S_OK.

Измерения применяются к размеру целевого видео, а не к общему размеру окна. Таким образом, при расчете размера устанавливаемого окна учитывайте текущие стили окна (например, WS_CAPTION и WS_BORDER).

Требования

Требование Значение
Заголовок
Ctlutil.h (включая Streams.h)
Библиотека
Strmbase.lib (розничные сборки);
Strmbasd.lib (отладочные сборки)

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

Класс CBaseControlWindow