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


Метод ISmartRenderEngine::GetGroupCompressor

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

Примечание

[Не рекомендуется. Этот API может быть удален из будущих выпусков Windows.]

 

Метод GetGroupCompressor извлекает фильтр сжатия для указанной группы.

Синтаксис

HRESULT GetGroupCompressor(
   long        Group,
   IBaseFilter **pCompressor
);

Параметры

Группа

Отсчитываемый от нуля индекс группы.

pCompressor

Получает указатель на интерфейс IBaseFilter фильтра сжатия. Он получает значение NULL , если фильтр сжатия отсутствует.

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

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Используйте этот метод для задания свойств фильтра сжатия, таких как частота ключевых кадров. Вызовите этот метод после вызова IRenderEngine::ConnectFrontEnd, но перед отрисовкой проекта. Затем запросите выходной контакт фильтра сжатия для интерфейса IAMVideoCompression , который содержит методы для настройки параметров сжатия. Когда все будет готово, отпустите интерфейс. Если вы вносите последующие изменения в временная шкала, вызовите ConnectFrontEnd, а затем снова вызовите Метод GetGroupCompressor, чтобы сбросить параметры сжатия.

Если значение *pCompressor не равно NULL, интерфейс IBaseFilter имеет число невыполненных ссылок. Не забудьте освободить интерфейс, когда вы закончите использовать его.

Примечание

Файл заголовка 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).

 

Требования

Требование Значение
Заголовок
Qedit.h
Библиотека
Strmiids.lib

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

Интерфейс ISmartRenderEngine

Коды ошибок и успешности