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

Статья
07/28/2023

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

Метод CheckCapabilities запрашивает, заданы ли в потоке возможности поиска.

Синтаксис

HRESULT CheckCapabilities(
  [in, out] DWORD *pCapabilities
);

Параметры

[in, out] pCapabilities

На входных данных — указатель на переменную, содержащую побитовое ИЛИ одного или нескольких AM_SEEKING_SEEKING_CAPABILITIES атрибутов. При возврате метода значение указывает, какой из этих атрибутов доступен.

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

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

Код возврата	Описание
S_FALSE	Некоторые, но не все возможности в pCapabilities присутствуют.
S_OK	Все возможности в pCapabilities присутствуют.
E_FAIL	Возможности в pCapabilities отсутствуют.
E_POINTER	Аргумент указателя NULL.

Если вас интересует только несколько конкретных возможностей, вызов этого метода более эффективен, чем вызов метода IMediaSeeking::GetCapabilities, который проверяет все возможности поиска потока.

Чтобы вызвать этот метод, объявите переменную DWORD и присвойте значению побитовую или комбинацию флагов AM_SEEKING_SEEKING_CAPABILITIES, которые требуется проверить. Передайте адрес этого значения в параметре pCapabilities . При возврате метода pCapabilities содержит подмножество исходных битов, указывающее, какие возможности присутствуют. Возвращаемое значение указывает, присутствуют ли некоторые, нет или все запрошенные возможности.

В следующем примере кода показано, как узнать, поддерживает ли поток поиск вперед, назад и абсолютный поиск.

C++
Установите флаги для возможностей, которые вы хотите проверка. DWORD dwCaps = AM_SEEKING_CanSeekAbsolute \| AM_SEEKING_CanSeekForwards \| AM_SEEKING_CanSeekBackwards; HRESULT hr = pMediaSeeking-CheckCapabilities>(&dwCaps); if(FAILED(hr)) { // Поток не может искать. } else if (hr == S_OK) { // The stream can seek forward, backward, and to an absolute position. } else if (hr == S_FALSE) // The stream has some of the capabilities. { if (dwCaps & AM_SEEKING_CanSeekAbsolute) { // The stream can seek to an absolute position. } if (dwCaps & AM_SEEKING_CanSeekForwards) { // The stream can seek forward. } if (dwCaps & AM_SEEKING_CanSeekBackwards) { // The stream can seek backward. } }

C++

Установите флаги для возможностей, которые вы хотите проверка.
DWORD dwCaps = AM_SEEKING_CanSeekAbsolute | AM_SEEKING_CanSeekForwards | AM_SEEKING_CanSeekBackwards;
HRESULT hr = pMediaSeeking-CheckCapabilities>(&dwCaps); if(FAILED(hr)) { // Поток не может искать.
} else if (hr == S_OK) {

// The stream can seek forward, backward, and to an absolute position.
}
else if (hr == S_FALSE) // The stream has some of the capabilities.
{
if (dwCaps & AM_SEEKING_CanSeekAbsolute)
{
// The stream can seek to an absolute position.
}
if (dwCaps & AM_SEEKING_CanSeekForwards)
{
// The stream can seek forward.
}
if (dwCaps & AM_SEEKING_CanSeekBackwards)
{
// The stream can seek backward.
}
}

Требования

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

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

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

Интерфейс IMediaSeeking