CBasePin.CBasePin 建構函式

  • 發行項

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

建構函式方法。

語法

CBasePin(
   TCHAR         *pObjectName,
   CBaseFilter   *pFilter,
   CCritSec      *pLock,
   HRESULT       *phr,
   LPCWSTR       pName,
   PIN_DIRECTION dir
);

參數

pObjectName

字串，其中包含 物件的偵錯名稱。 如需詳細資訊，請參閱 CBaseObject。

pFilter

建立此釘選之篩選的指標。

pLock

CCritSec鎖定的指標，用來序列化狀態變更。 可以是與篩選鎖定、 CBaseFilter：：m_pLock相同的關鍵區段。

phr

接收 HRESULT 值的變數指標，指出方法的成功或失敗。 在建立 物件之前，先將值初始化為S_OK。 只有在發生錯誤時，才會變更此值。

pName

包含釘選名稱的寬字元字串。 如需詳細資訊，請參閱 CBasePin：：QueryPinInfo。

dir

指定針腳方向 之PIN_DIRECTION 列舉的成員。

備註

pLock所指定的重要區段會序列化針腳的狀態，包括其線上狀態、配置器選擇、媒體類型，以及排清作業的狀態。 請勿使用此重要區段來序列化串流作業。 如需詳細資訊，請參閱 篩選圖形中的資料流程。

篩選準則可能會在其建構函式方法中建立釘選，因此此時 pFilter 指標可能不會參考有效的物件。 儲存指標，但不要在針腳的建構函式內取值指標。

規格需求

需求 值
標頭
Amfilter.h (包含 Streams.h)
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CBasePin 類別