NdisFSendNetBufferListsComplete (Compact 7)

  • Article

3/12/2014

Filter drivers call this function to return a linked list of NET_BUFFER_LIST structures to an overlying driver and to return the final status of a send request.

Syntax

VOID
  NdisFSendNetBufferListsComplete(
    IN NDIS_HANDLE  NdisFilterHandle,
    IN PNET_BUFFER_LIST  NetBufferLists,
    IN ULONG  SendCompleteFlags
    );

Parameters

  • NdisFilterHandle
    The NDIS handle that identifies this filter module. NDIS passed the handle to the filter driver in a call to the FilterAttach function.
  • NetBufferLists
    A pointer to a linked list of NET_BUFFER_LIST structures. The filter driver received the NET_BUFFER_LIST structures in previous calls to the FilterSendNetBufferLists function.
  • SendCompleteFlags
    NDIS flags that can be combined with an OR operation. To clear all the flags, set this member to zero. This function supports the NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL flag which; if set, indicates that the current IRQL is DISPATCH_LEVEL.

Return Value

None

Remarks

A filter driver calls the NdisFSendNetBufferListsComplete function to complete send requests that NDIS made to the driver's FilterSendNetBufferLists function. The filter driver specifies a linked list of NET_BUFFER_LIST structures that are associated with the completed send requests. While the status of the send requests is pending, the filter driver retains ownership of the NET_BUFFER_LIST structures and all the resources that are associated with the NET_BUFFER_LIST structures.

The filter driver can complete send requests in any order. For example, the filter driver could concatenate the NET_BUFFER_LIST structure lists from multiple FilterSendNetBufferLists calls or split up a list from a FilterSendNetBufferLists call. However, the filter driver must not modify the list of NET_BUFFER structures that are associated with a NET_BUFFER_LIST structure.

Requirements

Header

ndis.h

See Also

Reference

NDIS Functions for Filter Drivers
FilterAttach
FilterSendNetBufferLists
NET_BUFFER
NET_BUFFER_LIST