reGFILTERPINS 結構 (strmif.h)

  • 發行項

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

結構 REGFILTERPINS 包含用來註冊篩選的針腳資訊。

語法

typedef struct REGFILTERPINS {
  LPWSTR            strName;
  BOOL              bRendered;
  BOOL              bOutput;
  BOOL              bZero;
  BOOL              bMany;
  const CLSID       *clsConnectsToFilter;
  const WCHAR       *strConnectsToPin;
  UINT              nMediaTypes;
  const REGPINTYPES *lpMediaType;
} REGFILTERPINS;

成員

strName

針腳的名稱。 (已過時。)

bRendered

如果 為 TRUE，篩選條件會從這個針腳轉譯輸入。 (僅適用於輸入針腳。對於輸出針腳，此值一律為 FALSE.)

bOutput

如果 為TRUE，則此針腳是輸出針腳。 否則，針腳是輸入針腳。

bZero

如果 為 TRUE，篩選條件可以有這個針腳的零個實例。

bMany

如果 為 TRUE，篩選條件可以建立此類型針腳的多個實例。

clsConnectsToFilter

類別標識子 (CLSID) 此針腳連接的篩選。 (已過時。)

strConnectsToPin

這個針腳所連接的針腳名稱。 (已過時。)

nMediaTypes

此釘選所支持的媒體類型數目。

lpMediaType

REGPINTYPES 結構的陣列指標，大小為 nMediaTypes。

備註

此結構用於 IFilterMapper2 介面中，以用於篩選註冊。 如果您使用這個結構，請將 REGFILTER2 結構的 dwVersion 成員設定為 1。 如果您需要註冊針腳的中型或針腳類別，請改用 REGFILTERPINS2 結構。 在此情況下，請將結構的 dwVersion 成員REGFILTER2設定為 2。

對等 AMOVIESETUP_PIN 類型用於類別處理站範本中， (CFactoryTemplate) 。

strName、clsConnectsToFilter 和 strConnectsToPin 成員已過時。 其值不會新增至登錄。

如需詳細資訊，請參閱 如何註冊 DirectShow 篩選。

規格需求

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

另請參閱

DirectShow 結構