Метод ISampleGrabber::GetConnectedMediaType

  • Статья

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

Примечание

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

 

Метод GetConnectedMediaType извлекает тип носителя для подключения во входном контакте Sample Grabber.

Синтаксис

HRESULT GetConnectedMediaType(
   AM_MEDIA_TYPE *pType
);

Параметры

pType

Указатель на структуру AM_MEDIA_TYPE , выделенную вызывающим объектом.

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

Возвращает одно из следующих значений.

Код возврата Описание
E_POINTER
 Аргумент указателя NULL.
S_OK
 Успешно.
VFW_E_NOT_CONNECTED
 Фильтр не подключен.

 

Комментарии

Этот метод копирует тип носителя в структуру AM_MEDIA_TYPE , заданную параметром pType. Вызывающий объект должен освободить блок формата типа мультимедиа. В библиотеке базовых классов можно использовать функцию CoTaskMemFree или функцию FreeMediaType .

Примечание

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

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

Использование примера Grabber

Интерфейс ISampleGrabber