Метод 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 |