Share via


REGFILTER2結構 (strmif.h)

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

結構 REGFILTER2 包含註冊篩選的資訊。

語法

typedef struct REGFILTER2 {
  DWORD dwVersion;
  DWORD dwMerit;
  union {
    struct {
      ULONG               cPins;
      const REGFILTERPINS *rgPins;
    } DUMMYSTRUCTNAME;
    struct {
      ULONG                cPins2;
      const REGFILTERPINS2 *rgPins2;
    } DUMMYSTRUCTNAME2;
  } DUMMYUNIONNAME;
} REGFILTER2;

成員

dwVersion

篩選註冊格式。 如果值為 1,聯集會包含第一個未命名的結構。 如果值為 2,聯集會包含第二個未命名的結構。

dwMerit

篩選優點。 先列舉具有較高優點的篩選。 請參閱 優點

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.cPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME.rgPins

DUMMYUNIONNAME.DUMMYSTRUCTNAME2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.cPins2

DUMMYUNIONNAME.DUMMYSTRUCTNAME2.rgPins2

備註

這個結構會傳遞至 IFilterMapper2::RegisterFilter 方法。

如果您需要註冊針腳媒體或針腳類別,請將 dwVersion 設定為 2,並使用 REGFILTERPINS2 結構。

規格需求

需求
標頭 strmif.h (包含 Dshow.h)

另請參閱

DirectShow 結構