EthFilterIndicateReceive

EthFilterIndicateReceive

VOID
EthFilterIndicateReceive(
IN PETH_FILTER Filter,
IN NDIS_HANDLE MacReceiveContext,
IN PCHAR Address,
IN PVOID HeaderBuffer,
IN UINT HeaderBufferSize,
IN PVOID LookaheadBuffer,
IN UINT LookaheadBufferSize,
IN UINT PacketSize
);

EthFilterIndicateReceive is called by a NIC driver to indicate a received packet to all filter library database bindings associated with an Ethernet address.

Parameters

Filter

Points to a previously created and initialized filter library database.

MacReceiveContext

Specifies a context the NIC driver associates with a packet received from the network.

Address

Points to the destination address the NIC driver has already extracted from the received packet.

HeaderBuffer

Points to the virtual address of the virtually contiguous buffer containing the packet header. The buffer is valid only within the current call to this function.

HeaderBufferSize

Indicates the length, in bytes, of the packet header.

LookaheadBuffer

Points to the virtual address of the virtually contiguous buffer containing the first bytes of packet data. The packet buffer is valid only for the current call to this function.

LookaheadBufferSize

Specifies the size, in bytes, of the lookahead buffer.

PacketSize

Specifies the size, in bytes, of the received packet data. This parameter number is not related to the lookahead buffer, but rather indicates the size of the received packet data. This allows a protocol driver to call NdisTransferData and to transfer data in the packet, as necessary. The data length does not include the packet header length.

Comments

Instead of calling NdisIndicateReceive without filtering, the NIC driver calls EthFilterIndicateReceive to filter a received packet so only the appropriate bindings receive it. EthFilterIndicateReceive then calls the ProtocolReceive function of each protocol driver to which the binding filter applies.

In its calls to ProtocolReceive, this function passes each protocol driver a pointer to the packet header as well as a pointer to some or all of the packet data. The protocol driver can inspect the header and data in the packet, optionally copy as much of the header or data as is visible, or optionally call NdisTransferData to instruct the NIC driver to copy the data into a protocol–supplied packet.

Callers of EthFilterIndicateReceive run at IRQL <= DISPATCH_LEVEL.