Share via

NDIS_FILTER_INTERFACE (Compact 2013)

  • Article

3/26/2014

This structure defines the attributes for an NDIS filter.

Syntax

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;

Members

  • Header
    The NDIS_OBJECT_HEADER structure for the filter interface structure. NDIS sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NDIS_FILTER_INTERFACE_REVISION_1, and the Size member to NDIS_SIZEOF_FILTER_INTERFACE_REVISION_1.

  • Flags
    A bit field that defines the kind of NDIS driver that implements the filter. This member must be set to one of the following driver types:

    • NDIS_FILTER_INTERFACE_IM_FILTER
      The filter is implemented in an NDIS 5.1 or earlier filter intermediate driver.
    • NDIS_FILTER_INTERFACE_LW_FILTER
      The filter is implemented in an NDIS 6.0 or later versions filter driver.

  • FilterType
    The behavior type for the filter. This type must be one of the following values:

    • NdisFilterTypeMonitoring = 1
      A monitoring filter.
    • NdisFilterTypeModifying = 2
      A modifying filter.

  • FilterRunType
    The runtime attachment priority type for the filter. This type must be one of the following values:

    • NdisFilterRunTypeMandatory = 1
      A mandatory filter. If the filter does not attach to the driver stack, NDIS will tear down the rest of the stack.
    • NdisFilterRunTypeOptional = 2
      An optional filter. If the filter does not attach to the driver stack, NDIS will tear down the rest of the stack.
  • IfIndex
    The NDIS interface index of the filter module.
  • NetLuid
    The NET_LUID value that is assigned to the filter module. The NET_LUID is equal to the interface name (ifName in RFC 2863).
  • FilterClass
    A UNICODE string that specifies the filter class. This string is the same as the FilterClass INF file entry.
  • FilterInstanceName
    The filter instance name.

Remarks

The NdisEnumerateFilterModules function returns one NDIS_FILTER_INTERFACE structure for each filter in the driver stack. The Flags member identifies the filter as an NDIS 5.1 or earlier filter intermediate driver or an NDIS 6.0 or later versions NDIS filter module.

Requirements

Header

ndis.h

See Also

Reference

NDIS Filter Driver Structures
NDIS_OBJECT_HEADER
NdisEnumerateFilterModules

Other Resources

NET_LUID