Метод IMemInputPin::ReceiveCanBlock (strmif.h)

  • Статья

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

Метод ReceiveCanBlock определяет, могут ли блокироваться вызовы метода IMemInputPin::Receive .

Синтаксис

HRESULT ReceiveCanBlock();

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

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

Код возврата Описание
S_FALSE
 Закрепление не будет блокироваться при вызове метода receive
S_OK
 Закрепление может блокироваться при вызове receive.

Комментарии

Если этот метод возвращает S_FALSE, вызовы метода Receive гарантированно не будут блокироваться. В противном случае они могут блокироваться. Фильтр вышестоящий может использовать этот метод для определения стратегии потоков. Если вызовы receive могут блокироваться, фильтр вышестоящий может решить использовать рабочий поток, который буферизовывает данные.

Требования

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

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

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

Интерфейс IMemInputPin