Share via


PF_FILTER_DESCRIPTOR

[PF_FILTER_DESCRIPTOR is available for use in the operating systems listed in the Requirements section. It may be altered or unavailable in subsequent versions. The API elements described in the Windows Filtering Platform API Reference provide similar functionality.]

The PF_FILTER_DESCRIPTOR structure contains the information that defines a packet filter.

typedef struct _PF_FILTER_DESCRIPTOR {
  DWORD dwFilterFlags;
  DWORD dwRule;
  PFADDRESSTYPE pfatType;
  PBYTE SrcAddr;
  PBYTE SrcMask;
  PBYTE DstAddr;
  PBYTE DstMask;
  DWORD dwProtocol;
  DWORD fLateBound;
  WORD wSrcPort;
  WORD wDstPort;
  WORD wSrcPortHighRange;
  WORD wDstPortHighRange;
} PF_FILTER_DESCRIPTOR, 
 *PPF_FILTER_DESCRIPTOR;

Members

  • dwFilterFlags
    Currently only a single flag is supported for this member:

    FD_FLAGS_NOSYN

  • dwRule
    Specifies the rule for the filter.

  • pfatType
    Specifies the address type for the filter. This member is of type PFADDRESSTYPE.

  • SrcAddr
    Specifies the source address of the packets to filter. This information must be passed in the host byte order.

  • SrcMask
    Specifies the subnet mask for the source address. This information must be passed in the host byte order.

  • DstAddr
    Specifies the destination address of the packets to filter. This information must be passed in the host byte order.

  • DstMask
    Specifies the subnet mask for the destination address. This information must be passed in the host byte order.

  • dwProtocol
    Specifies the protocols to filter. This member can be one of the following values.

    Value Meaning
    FILTER_PROTO_ANY All protocols
    FILTER_PROTO_ICMP Internet Control Message Protocol
    FILTER_PROTO_TCP Transmission Control Protocol
    FILTER_PROTO_UDP User Datagram Protocol
  • fLateBound
    Specifies the address information that should be updated when the filter is rebound. This member can be any combination of the following flags:

    LB_SRC_ADDR_USE_SRCADDR_FLAG
    LB_SRC_ADDR_USE_DSTADDR_FLAG
    LB_DST_ADDR_USE_SRCADDR_FLAG
    LB_DST_ADDR_USE_DSTADDR_FLAG

  • wSrcPort
    Specifies the source port of the packets to filter.

  • wDstPort
    Specifies the destination port of the packets to filter.

  • wSrcPortHighRange
    Specifies the high range of the source port of packets to filter.

  • wDstPortHighRange
    Specifies the high range of the destination port of packets to filter.

Requirements

Server Requires Windows Server 2003 or Windows 2000 Server.
Header

Declared in Fltdefs.h.

See Also

PF_LATEBIND_INFO
PfAddFiltersToInterface
PfRebindFilters