NDIS_RECEIVE_FILTER_FIELD_PARAMETERS - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// ntddndis.h
typedef struct _NDIS_RECEIVE_FILTER_FIELD_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
NDIS_FRAME_HEADER FrameHeader;
NDIS_RECEIVE_FILTER_TEST ReceiveFilterTest;
union {
NDIS_MAC_HEADER_FIELD MacHeaderField;
NDIS_ARP_HEADER_FIELD ArpHeaderField;
NDIS_IPV4_HEADER_FIELD IPv4HeaderField;
NDIS_IPV6_HEADER_FIELD IPv6HeaderField;
NDIS_UDP_HEADER_FIELD UdpHeaderField;
} HeaderField;
_HEADER_FIELD _HEADER_FIELD;
union {
UCHAR FieldByteValue;
USHORT FieldShortValue;
ULONG FieldLongValue;
ULONG64 FieldLong64Value;
UCHAR FieldByteArrayValue[16];
} FieldValue;
_FIELD_VALUE _FIELD_VALUE;
union {
UCHAR ResultByteValue;
USHORT ResultShortValue;
ULONG ResultLongValue;
ULONG64 ResultLong64Value;
UCHAR ResultByteArrayValue[16];
} ResultValue;
_RESULT_VALUE _RESULT_VALUE;
} NDIS_RECEIVE_FILTER_FIELD_PARAMETERS, *PNDIS_RECEIVE_FILTER_FIELD_PARAMETERS;
View the official Windows Driver Kit DDI referenceNo description available.
The NDIS_RECEIVE_FILTER_FIELD_PARAMETERS structure specifies the filter test criterion for a field in a network packet header.
NDIS receive filters are used in the following NDIS interfaces:
HeaderThe NDIS_OBJECT_HEADER structure for the NDIS_RECEIVE_FILTER_FIELD_PARAMETERS structure. The driver sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT.
To indicate the version of the NDIS_RECEIVE_FILTER_FIELD_PARAMETERS structure, the driver sets the Revision member to one of the following values:
| Value | Meaning |
|---|---|
| NDIS_RECEIVE_FILTER_FIELD_PARAMETERS_REVISION_2 2 |
Added additional members to the HeaderField union for NDIS 6.30. The driver sets the Size member to NDIS_SIZEOF_RECEIVE_FILTER_FIELD_PARAMETERS_REVISION_2. |
| NDIS_RECEIVE_FILTER_FIELD_PARAMETERS_REVISION_1 1 |
Original version for NDIS 6.20. The driver sets the Size member to NDIS_SIZEOF_RECEIVE_FILTER_FIELD_PARAMETERS_REVISION_1. |
FlagsA bitwise OR of flags. The following flags are valid for the OID_RECEIVE_FILTER_SET_FILTER OID.
| Value | Meaning |
|---|---|
| NDIS_RECEIVE_FILTER_FIELD_MAC_HEADER_VLAN_UNTAGGED_OR_ZERO 0x00000001 |
If this flag is set, the network adapter must only indicate received packets that pass the following criteria: * The packet's media access control (MAC) address matches the specified MAC header field test. * The packet either does not contain a VLAN tag or has a VLAN tag with an ID of zero. For more information about this flag, see the Remarks section. Note If an overlying driver sets a MAC address filter and a VLAN identifier filter with an OID request of OID_RECEIVE_FILTER_SET_FILTER, it does not set this flag in either of the filter fields. In this case, the miniport driver should indicate packets that match both the specified MAC address and the VLAN identifier. That is, the miniport driver should not indicate packets with a matching MAC address that have a zero VLAN identifier or are untagged packets. |
FrameHeaderThe type of header in the network data frame.
ReceiveFilterTestThe type of test to perform for the receive filter.
HeaderFieldThe type of field in a header. The field type (for example, NDIS_MAC_HEADER_FIELD) corresponds to the type of header that is specified in the FrameHeader member.
This union contains the following members:
HeaderField.MacHeaderFieldThe type of field in a MAC header.
HeaderField.ArpHeaderFieldThe type of field in an Address Resolution Protocol (ARP) header.
HeaderField.IPv4HeaderFieldAn NDIS_IPV4_HEADER_FIELD enumeration value that specifies the type of field in an IP version 4 (IPv4) header.
HeaderField.IPv6HeaderFieldAn NDIS_IPV6_HEADER_FIELD enumeration value that specifies the type of field in an IP version 6 (IPv6) header.
HeaderField.UdpHeaderFieldThe type of field in a User Datagram Protocol (UDP) header.
_HEADER_FIELDFieldValueThe value that the miniport adapter compares to the corresponding header field value in incoming packets. The location of the header field value is determined by the field type that is specified in the HeaderField member.
For more information, see the Remarks section.
This union contains the following members:
FieldValue.FieldByteValueA UCHAR value to compare with a field in a network packet.
Note If the MacHeaderField member specifies an NdisMacHeaderFieldPacketType enumeration value, this member contains an NDIS_MAC_PACKET_TYPE enumeration value.
FieldValue.FieldShortValueA USHORT value to compare with a field in a network packet.
FieldValue.FieldLongValueA ULONG value to compare with a field in a network packet.
FieldValue.FieldLong64ValueA ULONG64 value to compare with a field in a network packet.
FieldValue.FieldByteArrayValueA UCHAR array to compare with a field in a network packet.
_FIELD_VALUEResultValueA union that contains a test result value.
If the ReceiveFilterTest member is set to NdisReceiveFilterTestMaskEqual, the network adapter first calculates a result from the value in the FieldValue member and the header field value as specified by the HeaderField member. The adapter then compares the calculated result with ResultValue.
For more information, see the Remarks section.
This union contains the following members:
ResultValue.ResultByteValueA UCHAR value to compare with a test result.
ResultValue.ResultShortValueA USHORT value to compare with a test result.
ResultValue.ResultLongValueA ULONG value to compare with a test result.
ResultValue.ResultLong64ValueA ULONG64 value to compare with a test result.
ResultValue.ResultByteArrayValueA UCHAR array to compare with a test result.
_RESULT_VALUEThe NDIS_RECEIVE_FILTER_FIELD_PARAMETERS structure specifies the filter test criterion for one field in a possible array of field tests that can be specified with the NDIS_RECEIVE_FILTER_PARAMETERS structure.
The following table describes how the network adapter uses the ReceiveFilterTest, FieldValue, and ResultValue members to perform a filter test on the specified header field value of a received packet.
| ReceiveFilterTest value | Filter test performed by network adapter |
|---|---|
| NdisReceiveFilterTestEqual | (<header field value> == FieldValue) |
| NdisReceiveFilterTestMaskEqual | ((<header field value> & FieldValue) == ResultValue) |
| NdisReceiveFilterTestNotEqual | (<header field value> != FieldValue) |
Note All the multibyte field and result values, such as the FieldShortValue and ResultLong64Value members, must be specified in network byte order (big-endian) format.
If the NDIS_RECEIVE_FILTER_FIELD_MAC_HEADER_VLAN_UNTAGGED_OR_ZERO flag is not set and there is no VLAN identifier filter that was configured by an OID set request of OID_RECEIVE_FILTER_SET_FILTER, the miniport driver must do one of the following:
Starting with NDIS 6.30, if the NDIS_RECEIVE_FILTER_FIELD_MAC_HEADER_VLAN_UNTAGGED_OR_ZERO flag is not set and there is no VLAN identifier filter configured by the OID_RECEIVE_FILTER_SET_FILTER method request, the miniport driver must do either one of the following:
Starting with NDIS 6.30, if the NDIS_RECEIVE_FILTER_FIELD_MAC_HEADER_VLAN_UNTAGGED_OR_ZERO flag is not set and there is a non-zero VLAN identifier filter that was configured by an OID set request of OID_RECEIVE_FILTER_SET_FILTER, the miniport driver must do the following:
The miniport driver must configure the network adapter to inspect and filter the specified MAC address and VLAN identifier fields.
If a VLAN tag is present in the received packet, the network adapter must remove it from the packet data. The miniport driver must put the VLAN tag in an NDIS_NET_BUFFER_LIST_8021Q_INFO that is associated with the packet's NET_BUFFER_LIST structure.
NDIS_RECEIVE_FILTER_PARAMETERS