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


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

[Функция, связанная с этой страницей 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