Метод IRenderEngine::GetGroupOutputPin
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Примечание
[Не рекомендуется. Этот API можно удалить из будущих выпусков Windows.]
Метод GetGroupOutputPin извлекает выходную закрепку для указанной группы.
Синтаксис
HRESULT GetGroupOutputPin(
long Group,
[out] IPin **ppRenderPin
);
Параметры
-
Группа
-
Отсчитываемый от нуля индекс, указывающий группу.
-
ppRenderPin [out]
-
Получает указатель на интерфейс IPin выходного контакта.
Возвращаемое значение
Возвращает значение HRESULT . Возможные значения:
| Код возврата | Описание |
|---|---|
|
Группа не имеет выходного закрепления. |
|
Успешно. |
|
Недопустимый аргумент. |
|
Не удалось инициализировать подсистему отрисовки. |
|
Недопустимый указатель. |
|
Операция завершилась сбоем, так как проект не был успешно отрисован. |
|
Непредвиденная ошибка. |
Комментарии
Перед вызовом этого метода вызовите IRenderEngine::ConnectFrontEnd , чтобы создать внешний интерфейс графа. Каждая группа представляет один поток мультимедиа, а внешний интерфейс имеет соответствующую выходную закрепку.
Этот метод можно использовать для создания части отрисовки графа для записи файлов. Подключите выходные контакты к фильтрам мультиплексоров и фильтрам записи файлов. Дополнительные сведения см. в разделе Отрисовка проекта.
Для предварительной версии вызывать этот метод не нужно. Просто вызовите ConnectFrontEnd и IRenderEngine::RenderOutputPins.
Если метод возвращает S_OK, интерфейс IPin , который он возвращает, имеет неоплаченное число ссылок. Не забудьте освободить интерфейс после завершения его использования.
Примечание
Файл заголовка 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).
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел