IFilterGraph2：：AddSourceFilterForMoniker 方法 (strmif.h)

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

方法 AddSourceFilterForMoniker 會從 IMoniker 指標建立來源篩選，並將篩選新增至圖形。 例如，您可以取得系統裝置的 Moniker，例如視訊擷取裝置，並新增該裝置的視訊擷取篩選。 (如需系統裝置 Monikers 的詳細資訊，請參閱 ICreateDevEnum 介面.)

語法

HRESULT AddSourceFilterForMoniker(
  [in]  IMoniker    *pMoniker,
  [in]  IBindCtx    *pCtx,
  [in]  LPCWSTR     lpcwstrFilterName,
  [out] IBaseFilter **ppFilter
);

參數

[in] pMoniker

IMoniker介面的指標。

[in] pCtx

IBindCtx系結內容介面的指標。

[in] lpcwstrFilterName

篩選的名稱。

[out] ppFilter

接收來源篩選之 IBaseFilter 指標的指標。 呼叫端必須釋放 介面。

傳回值

會傳回 和 HRESULT 值。 可能的值如下。

備註

Filter Graph Manager 會保留篩選的參考計數，直到從圖形中移除篩選或篩選圖形管理員釋放為止。

範例

IBaseFilter *pSource = Null;IMoniker *pMoniker = Null;
使用 IEnumMonikers 取得 IMoniker 指標。  (未顯示.) 
// Create a bind context for working with the moniker.
IBindCtx pContext=0;
hr = CreateBindCtx(0, &pContext);
if (SUCCEEDED(hr))
{
// Query the Filter Graph Manager for IFilterGraph2.
IFilterGraph2 pFG2 = NULL;
hr = pGraph->QueryInterface(IID_IFilterGraph2, (void)&pFG2);
if (SUCCEEDED(hr))
{
// Create the source filter.
hr = pFG2->AddSourceFilterForMoniker(pMoniker, pContext,
L"Source", &pSource);
pFG2->Release();
}
pContext->Release();
}
pMoniker->Release();

規格需求

另請參閱

錯誤和成功碼

IFilterGraph2 介面