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


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

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

Метод GetCapability извлекает общие возможности транспорта.

Синтаксис

HRESULT GetCapability(
  [in]  long   Capability,
  [out] long   *pValue,
  [out] double *pdblValue
);

Параметры

[in] Capability

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

[out] pValue

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

[out] pdblValue

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

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

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

Комментарии

Параметр Capability — это флаг, указывающий, какую возможность проверка. Метод возвращает результат в параметре pValue или в параметре pdblValue в зависимости от флага возможности.

Для следующих флагов метод возвращает значение OATRUE или OAFALSE в параметре pValue . Значение OATRUE указывает, что возможность присутствует, а значение OAFALSE указывает, что она отсутствует.

Флаг возможности Описание
ED_TRANSCAP_CAN_ASSEMBLE Транспорт может использовать режим записи сборки (запись новых дорожек, которые легко связываются с треком управления из ранее записанного сегмента).
ED_TRANSCAP_CAN_BUMP_PLAY Транспорт может синхронизироваться с разной скоростью.
ED_TRANSCAP_CAN_DELAY_AUDIO_IN Транспорт может выполнять отложенные изменения звука.
ED_TRANSCAP_CAN_DELAY_AUDIO_OUT Транспорт может выполнять отложенные изменения звука.
ED_TRANSCAP_CAN_DELAY_VIDEO_IN Транспорт может выполнять отложенные изменения видео.
ED_TRANSCAP_CAN_DELAY_VIDEO_OUT Транспорт может выполнять отложенные изменения видео.
ED_TRANSCAP_CAN_DETECT_LENGTH Транспорт может определять длину носителя.
ED_TRANSCAP_CAN_EJECT Транспорт может извлекать носитель.
ED_TRANSCAP_CAN_FREEZE Транспорт может заморозить или приостановить.
ED_TRANSCAP_CAN_INSERT Транспорт может использовать режим вставки записей (запись отдельных дорожек при блокировке предварительно записанной дорожки элемента управления).
ED_TRANSCAP_CAN_PLAY_BACKWARDS Транспорт может играть назад.
ED_TRANSCAP_CAN_SET_EE Транспорт может отображать входные данные устройства на его выходных данных.
ED_TRANSCAP_CAN_SET_PB Транспорт может отображать воспроизведение мультимедиа на своих выходных данных.
ED_TRANSCAP_FIELD_STEP Транспорт реагирует на команду продвижения кадра, перемещая одно поле.
ED_TRANSCAP_HAS_CLOCK Устройство имеет часы.
ED_TRANSCAP_HAS_DT Устройство имеет динамическое отслеживание.
ED_TRANSCAP_HAS_TIMER Устройство имеет таймер.
ED_TRANSCAP_HAS_TUNER Устройство имеет тюнер.
ED_TRANSCAP_IS_MASTER Устройство — это master часов для синхронизации.
ED_TRANSCAP_MULTIPLE_EDITS Устройство поддерживает несколько событий редактирования.
ED_TRANSCAP_NEEDS_CUEING Устройство должно быть объявлено перед выполнением редактирования.
ED_TRANSCAP_NEEDS_TBC Устройство должно быть откалибровано.
 

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

Флаг возможности Возвращаемое значение
ED_TRANSCAP_LTC_TRACK Возвращает номер дорожки кода времени LTC или ED_ALL, если выделенная дорожка кода времени отсутствует.
ED_TRANSCAP_NUM_AUDIO_TRACKS Возвращает количество звуковых дорожек.
 

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

Флаг возможности Возвращаемое значение
ED_TRANSCAP_FWD_SHUTTLE_MAX Максимальная скорость вперед в режиме челнока, кратная скорости игры.
ED_TRANSCAP_FWD_SHUTTLE_MIN Минимальная скорость вперед в режиме челнока, кратная скорости игры.
ED_TRANSCAP_FWD_VARIABLE_MAX Максимальная скорость вперед, кратная скорости игры.
ED_TRANSCAP_FWD_VARIABLE_MIN Минимальная скорость вперед, кратная скорости игры.
ED_TRANSCAP_REV_SHUTTLE_MAX Максимальная обратная скорость в режиме челнока, кратная скорости игры.
ED_TRANSCAP_REV_SHUTTLE_MIN Минимальная обратная скорость в режиме челнока, кратная скорости игры.
ED_TRANSCAP_REV_VARIABLE_MAX Максимальная обратная скорость, кратная скорости игры.
ED_TRANSCAP_REV_VARIABLE_MIN Минимальная обратная скорость, кратная скорости игры.
 

Реализация DV

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

Требования

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

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

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

Интерфейс IAMExtTransport