共用方式為

IAMFilterData：：CreateFilterData 方法

  • 發行項

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

注意

這個介面已被取代。 新的應用程式不應該使用它。

 

方法 CreateFilterData 會建立篩選準則的二進位登錄資料。 此資料可以寫入登錄，作為名為 FilterData 的REG_BINARY子機碼，在篩選準則的 CLSID 機碼底下。

應用程式通常沒有理由呼叫這個方法。 IFilterMapper2：：RegisterFilter方法會自動建立二進位資料，並將它新增至登錄中的正確位置。 如需詳細資訊，請參閱 如何註冊 DirectShow 篩選。

語法

HRESULT CreateFilterData(
  [in]  REGFILTER2 *prf2,
  [out] BYTE       **prgbFilterData,
  [out] ULONG      *pcb
);

參數

prf2 [in]

包含篩選資訊的 REGFILTER2 結構的指標。

prgbFilterData [out]

接收二進位資料指標的變數位址。 方法會配置資料的記憶體。 呼叫端必須藉由呼叫 CoTaskMemFree 方法釋放記憶體。

#[ out]

以位元組為單位接收二進位資料大小的變數指標。

傳回值

如果方法成功，它會傳回 S_OK。 如果方法失敗，則會傳回錯誤碼。

備註

注意

標頭 Fil_data.h 位於 Windows SDK 的 Mapper 範例 目錄中。

 

規格需求

需求 值
標頭
Fil_data.h
DLL
Quartz.dll

另請參閱

IAMFilterData 介面