Метод IMediaSeeking::GetAvailable (strmif.h)

  • Статья

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

Метод GetAvailable извлекает диапазон времени, в котором поиск является эффективным.

Синтаксис

HRESULT GetAvailable(
  [out] LONGLONG *pEarliest,
  [out] LONGLONG *pLatest
);

Параметры

[out] pEarliest

Указатель на переменную, которая получает самое раннее время для эффективного поиска.

[out] pLatest

Указатель на переменную, которая получает последнее время для эффективного поиска.

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата Описание
S_OK
 Успешно.
E_NOTIMPL
 Метод не поддерживается.
E_POINTER
 Аргумент указателя NULL.

Комментарии

Этот метод предназначен в основном для поиска в потоках мультимедиа, которые могут иметь чрезмерную задержку, например потоки, отправляемые по сети. Возвращаемые значения указывают на уже полученные кэшированные данные, которые можно легко найти. Предполагается, что поиск значений, превышающих эти возвращаемые параметры, приведет к задержке, пока приложение ожидает поступления данных.

Все значения времени выражаются в формате текущего времени. Формат времени по умолчанию — REFERENCE_TIME единиц (100 наносекунд). Чтобы изменить форматы времени, используйте метод IMediaSeeking::SetTimeFormat .

Требования

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

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

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

Интерфейс IMediaSeeking