NDIS_FILTER_INTERFACE結構 (ndis.h)

發行項
03/05/2024

NDIS_FILTER_INTERFACE 結構會定義 NDIS 篩選的屬性。

語法

typedef struct _NDIS_FILTER_INTERFACE {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              FilterType;
  ULONG              FilterRunType;
  NET_IFINDEX        IfIndex;
  NET_LUID           NetLuid;
  NDIS_STRING        FilterClass;
  NDIS_STRING        FilterInstanceName;
} NDIS_FILTER_INTERFACE, *PNDIS_FILTER_INTERFACE;

成員

Header

篩選介面結構的 NDIS_OBJECT_HEADER 結構。

NDIS 會將 Header 所指定之結構的 Type 成員設定為NDIS_OBJECT_TYPE_DEFAULT。

如果傳遞至 NdisEnumerateFilterModules 的句柄屬於 NDIS 6.30 或更新版本物件，則 NDIS 會將 Revision 設定為 NDIS_FILTER_INTERFACE_REVISION_2， 並將 Size 設定為 NDIS_SIZEOF_FILTER_INTERFACE_REVISION_2。

如果傳遞至 NdisEnumerateFilterModules 的句柄屬於 NDIS 6.20 或更早版本物件，則 NDIS 會將 Revision 設定為 NDIS_FILTER_INTERFACE_REVISION_1， 並將 Size 設定為 NDIS_SIZEOF_FILTER_INTERFACE_REVISION_1。

Flags

定義實作篩選之 NDIS 驅動程式類型的位欄位。此成員必須設定為下列其中一種驅動程式類型：

NDIS_FILTER_INTERFACE_IM_FILTER

篩選是在 NDIS 5.1 或更早的篩選中繼驅動程式中實作。

NDIS_FILTER_INTERFACE_LW_FILTER

篩選條件是在 NDIS 6.0 或更新版本的篩選驅動程式中實作。

NDIS_FILTER_INTERFACE_SEND_BYPASS

篩選目前未附加至傳送路徑。只有當 Header.Revision 大於或等於NDIS_FILTER_INTERFACE_REVISION_2時，才會設定此旗標。

NDIS_FILTER_INTERFACE_RECEIVE_BYPASS

篩選目前未附加至接收路徑。只有當 Header.Revision 大於或等於NDIS_FILTER_INTERFACE_REVISION_2時，才會設定此旗標。

FilterType

篩選的行為類型。這個類型必須是下列其中一個值：

NdisFilterTypeMonitoring = 1

監視篩選條件。

NdisFilterTypeModifying = 2

修改篩選條件。

FilterRunType

篩選條件的運行時間附件優先順序類型。這個類型必須是下列其中一個值：

NdisFilterRunTypeMandatory = 1

強制篩選條件。如果篩選未附加至驅動程式堆疊，NDIS 將會卸載堆疊的其餘部分。

NdisFilterRunTypeOptional = 2

選擇性篩選。如果篩選未附加至驅動程式堆疊，NDIS 將不會終止堆疊的其餘部分。

IfIndex

篩選模組的 NDIS 介面索引。

NetLuid

指派給篩選模組的NET_LUID 值。 NET_LUID相當於 RFC 2863) 中 ifName 的介面名稱 (。

FilterClass

指定篩選類別的 UNICODE 字串。此字串與 FilterClass INF 檔案專案相同。

FilterInstanceName

篩選實例名稱。

備註

The NdisEnumerateFilterModules 函式會針對驅動程式堆疊中的每個篩選傳回一個NDIS_FILTER_INTERFACE結構。 Flags 成員會將篩選識別為 NDIS 5.1 或更早版本的篩選中繼驅動程式或 NDIS 6.0 或更新版本的 NDIS 篩選模組。

輕量篩選條件可以藉由呼叫 NdisFRestartFilter 並將 NDIS_FILTER_PARTIAL_CHARACTERISTICS 結構提供給 NdisSetOptionalHandlers，以動態方式從傳送或接收路徑中插入或移除本身。

規格需求

需求	值
最低支援的用戶端	NDIS 6.0 和更新版本支援。
標頭	ndis.h (包括 Ndis.h)

另請參閱

NDIS_OBJECT_HEADER

NET_LUID

NdisEnumerateFilterModules

共用方式為