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

Статья
03/02/2024

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

Метод SetTransportBasicParameters задает общие свойства транспорта.

Синтаксис

HRESULT SetTransportBasicParameters(
  [in] long      Param,
  [in] long      Value,
  [in] LPCOLESTR pszData
);

Параметры

[in] Param

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

[in] Value

Задает значение свойства в виде длинного целого числа. Дополнительные сведения см. в разделе "Примечания".

[in] pszData

Задает значение свойства в виде LPOLESTR. Дополнительные сведения см. в разделе "Примечания".

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

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

Код возврата	Описание
E_NOTIMPL	Устройство не поддерживает настройку этого свойства.
ERROR_DEVICE_REMOVED	Устройство было удалено.

Параметр Param — это флаг, указывающий, какое свойство следует задать. Для некоторых флагов свойство является числовым; Используйте параметр Value , чтобы указать значение. Для других флагов свойство является строкой; Используйте параметр pszData , чтобы указать значение . В любом случае метод игнорирует другой параметр.

Для следующих флагов параметр Value принимает определенную константу.

ED_TRANSBASIC_TIME_FORMAT: задает формат времени.

Константа	Описание
ED_FORMAT_MILLISECONDS	За миллисекунды.
ED_FORMAT_FRAMES	Кадров.
ED_FORMAT_REFERENCE_TIME	Время ссылки.
ED_FORMAT_HMSF	Двоичное закодированное десятичное число, представляющее часы, минуты, секунды и кадры.
ED_FORMAT_TMSF	Двоичное закодированное десятичное значение, представляющее дорожки, минуты, секунды и кадры.

ED_TRANSBASIC_TIME_REFERENCE: указывает время, используемое устройством.

Константа	Описание
ED_TIMEREF_TIMECODE	Код времени.
ED_TIMEREF_CONTROL_TRACK	Контрольная дорожка.
ED_TIMEREF_INDEX	Индекс.
ED_TIMEREF_ATN	Абсолютный номер дорожки. Эта константа определена в файле заголовка Xprtdefs.h.

ED_TRANSBASIC_END_STOP_ACTION: указывает действие, выполняемое устройством при достижении конца транспортного носителя.

Константа Описание

ED_MODE_STOP Остановка.

ED_MODE_REWIND Перемотки.

ED_MODE_FREEZE Заморозка или приостановка.
ED_TRANSBASIC_RECORD_FORMAT: задает скорость записи.

Константа Описание

ED_RECORD_FORMAT_SP Стандартная игра.

ED_RECORD_FORMAT_LP Долгая игра.

ED_RECORD_FORMAT_EP Расширенная игра.
ED_TRANSBASIC_SUPERIMPOSE: указывает, включен или отключен экранный дисплей.

Константа Описание

ОАТРУЕ Экранный дисплей включен.

OAFALSE Экранный экран отключен.
ED_TRANSBASIC_STEP_UNIT: задает единицу шага.

Константа Описание

ED_STEP_FIELD Поля.

ED_STEP_FRAME Кадров.

ED_STEP_3_2 3/2 Вытягивание.
ED_TRANSBASIC_SET_COUNTER_FORMAT: задает формат времени для счетчика. Возможные значения см. в флаге ED_TRANSBASIC_TIME_FORMAT.

Константа	Описание
ED_MODE_STOP	Остановка.
ED_MODE_REWIND	Перемотки.
ED_MODE_FREEZE	Заморозка или приостановка.

Константа	Описание
ED_RECORD_FORMAT_SP	Стандартная игра.
ED_RECORD_FORMAT_LP	Долгая игра.
ED_RECORD_FORMAT_EP	Расширенная игра.

Константа	Описание
ОАТРУЕ	Экранный дисплей включен.
OAFALSE	Экранный экран отключен.

Константа	Описание
ED_STEP_FIELD	Поля.
ED_STEP_FRAME	Кадров.
ED_STEP_3_2	3/2 Вытягивание.

Для следующих флагов используйте числовое значение в параметре Value .

Flag	Описание
ED_TRANSBASIC_STEP_COUNT	Указывает количество шагов в единицах, определенных флагом ED_TRANSBASIC_STEP_UNIT.
ED_TRANSBASIC_SET_FREEZE_TIMEOUT	Указывает время ожидания для режима заморозки в единицах текущего формата времени.
ED_TRANSBASIC_SETCLOCK	Задает время часов.
ED_TRANSBASIC_SET_COUNTER_VALUE	Задает значение счетчика.

Для следующих флагов используйте строку в параметре pszData .

Flag	Описание
ED_TRANSBASIC_VOLUME_NAME	Указывает имя тома.

Реализация DV

MSDV не поддерживает этот метод. Он возвращает E_NOTIMPL.

Требования

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

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

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

Интерфейс IAMExtTransport

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