共用方式為

IGraphConfig：:P ushThroughData 方法 (strmif.h)

  • 發行項

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

方法會將 PushThroughData 資料透過篩選圖形推送至指定的針腳。

語法

HRESULT PushThroughData(
  [in] IPin           *pOutputPin,
  [in] IPinConnection *pConnection,
  [in] HANDLE         hEventAbort
);

參數

[in] pOutputPin

篩選圖形中輸出釘選的 IPin 介面指標。

[in] pConnection

篩選圖形中輸入針腳的 IPinConnection 介面指標。 此參數可以是 Null。

[in] hEventAbort

事件的控制代碼。 如果呼叫端是其中一個資料處理執行緒上的篩選呼叫，這個參數應該是當篩選進入停止狀態時將發出訊號的事件控制碼。 否則，此參數可以是 Null。 如需詳細資訊，請參閱＜備註＞。

傳回值

如果成功，則傳回S_OK。 否則，傳回錯誤碼，可能是下列其中一個值，或未列出其他值。

傳回碼 Description
E_OUTOFMEMORY
 無法配置必要的記憶體。
VFW_E_NOT_FOUND
 找不到候選輸入針腳。
VFW_E_STATE_CHANGED
 作業期間已變更篩選狀態。

備註

這個方法會透過任何擱置的資料，從指定的輸出釘選向下推送至指定的輸入針腳。 您可以選擇性地將輸入針腳保留為未指定，並讓方法搜尋篩選圖表以取得最佳候選項目。 請勿從推送資料的執行緒呼叫這個方法。

如果篩選準則在其自己的資料處理執行緒上呼叫此方法，它就會建立死結的可能性。 方法會取得篩選圖形上的鎖定，這可封鎖篩選在接收 IMediaFilter：：Stop呼叫時停止篩選。 若要避免這種情況，方法會接受篩選所提供之事件物件的控制碼。 如果篩選收到對 Stop 方法的呼叫，篩選準則應該會發出事件訊號。

規格需求

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

另請參閱

錯誤和成功碼

IGraphConfig 介面