Метод IAMExtTransport::GetTransportBasicParameters (strmif.h)

Статья
03/05/2024

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

Метод GetTransportBasicParameters извлекает общие свойства внешнего транспорта.

Синтаксис

HRESULT GetTransportBasicParameters(
  [in]      long     Param,
  [in, out] long     *pValue,
  [in, out] LPOLESTR *ppszData
);

Параметры

[in] Param

Указывает, какое свойство следует получить.

[in, out] pValue

Указатель на переменную, получающую длинное целочисленное значение. Дополнительные сведения см. в разделе "Примечания".

[in, out] ppszData

Указатель на переменную типа LPOLESTR , которая получает строку. Дополнительные сведения см. в разделе "Примечания".

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

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

Параметр Param является флагом, указывающим, какое свойство следует извлечь. Некоторые свойства являются числовыми; они возвращаются в параметре pValue . Другие свойства являются строковыми значениями; они возвращаются в параметре ppszData . Список флагов и ожидаемых значений см. в разделе IAMExtTransport::SetTransportBasicParameters.

Если метод возвращает строку, вызывающий объект должен освободить ее с помощью функции CoTaskMemFree .

Реализация DV и MPEG Camcorder

MSDV поддерживает следующие дополнительные флаги:

ED_RAW_EXT_DEV_CMD. Вызывает необработанную команду AV/C. Укажите команду AV/C в качестве массива байтов в параметре ppszData . Укажите размер команды в байтах в параметре pValue . При возврате метода ppszData содержит ответ от устройства, а pValue — размер ответа в байтах. Команда AV/C передается непосредственно на устройство без проверки или проверки ошибок.
Полезные данные ответа могут быть больше, чем команда. Вызывающий объект отвечает за выделение достаточного пространства в буфере для ответа. Максимальный размер полезных данных составляет 512 байт.

Дополнительные сведения см. в разделе Выдача необработанных команд AV/C.

ED_TRANSBASIC_INPUT_SIGNAL: извлекает формат сигнала, который предназначен для приема цифровой видеокамерой. Возвращает одну из следующих констант в pValue.

Константа	Описание
ED_TRANSBASIC_SIGNAL_525_60_SD	Сигнал NTSC SD.
ED_TRANSBASIC_SIGNAL_525_60_SDL	Сигнал NTSC SDL (long-play).
ED_TRANSBASIC_SIGNAL_625_50_SD	Сигнал PAL SD.
ED_TRANSBASIC_SIGNAL_625_50_SDL	Сигнал PAL SDL (long-play).
ED_TRANSBASIC_SIGNAL_MPEG2TS	Сигнал D-VHS.

ED_TRANSBASIC_OUTPUT_SIGNAL: извлекает формат сигнала, для передачи которого предназначена видеокамера DV. Возвращает одну из констант, перечисленных для флага ED_TRANSBASIC_INPUT_SIGNAL.

MSTape поддерживает дополнительные значения для ED_TRANSBASIC_INPUT_SIGNAL и ED_TRANSBASIC_OUTPUT_SIGNAL.

Константа	Описание
ED_TRANSBASIC_SIGNAL_2500_60_MPEG	25 Мбит/с/60 mpeg stream.
ED_TRANSBASIC_SIGNAL_1250_60_MPEG	12,5 Мбит/с/60 mpeg stream.
ED_TRANSBASIC_SIGNAL_0625_60_MPEG	6,25 Мбит/с/60 mpeg stream.
ED_TRANSBASIC_SIGNAL_2500_50_MPEG	25 Мбит/с/50 mpeg stream.
ED_TRANSBASIC_SIGNAL_1250_50_MPEG	12,5 Мбит/с/50 mpeg stream.
ED_TRANSBASIC_SIGNAL_0625_50_MPEG	6,25 Мбит/с/50 mpeg stream.
ED_TRANSBASIC_SIGNAL_UNKNOWN	Неизвестный формат сигнала.

Эти флаги определены в файле заголовка Xprtdefs.h.

В Windows XP с пакетом обновления 2 (SP2) и более поздних версиях для флагов ED_TRANSBASIC_INPUT_SIGNAL и ED_TRANSBASIC_OUTPUT_SIGNAL определены следующие дополнительные типы сигналов.

Константа	Описание
ED_TRANSBASIC_SIGNAL_525_60_DV25	DVCPRO 25, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV25	DVCPRO 25, 625-50.
ED_TRANSBASIC_SIGNAL_525_60_DV50	DVCPRO 50, 525-60.
ED_TRANSBASIC_SIGNAL_625_50_DV50	DVCPRO 50, 625-50.
ED_TRANSBASIC_SIGNAL_HD_60_DVH1	DVCPRO 100, 1080i или 720p
ED_TRANSBASIC_SIGNAL_HD_50_DVH1	Только DVCPRO 100, 1080i

Чтобы использовать эти константы, добавьте файл заголовка Xprtdefs.h из Windows SDK.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)
Библиотека	Strmiids.lib

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

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

Интерфейс IAMExtTransport

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