IMemInputPin：：ReceiveCanBlock 方法 (strmif.h)

  • 發行項

[與此頁面相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

方法 ReceiveCanBlock 會判斷 IMemInputPin：：Receive 方法的呼叫是否可能會封鎖。

Syntax

HRESULT ReceiveCanBlock();

傳回值

傳回 HRESULT 值。 可能的值包括下表所示的值。

傳回碼 Description
S_FALSE
 針腳不會在對Receive的呼叫上封鎖
S_OK
 針腳可能會在呼叫 [接收] 時封鎖。

備註

如果這個方法傳回S_FALSE，則保證 不會封鎖對 Receive 方法的呼叫。 否則，它們可能會封鎖。 上游篩選準則可以使用這個方法來判斷其執行緒策略。 如果呼叫 Receive 可以封鎖，上游篩選準則可能會決定使用緩衝資料的背景工作執行緒。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IMemInputPin 介面