NdisFReturnNetBufferLists (Compact 7)

3/12/2014

Filter drivers call this function to release the ownership of one or more NET_BUFFER_LIST structures and their associated NET_BUFFER structures.

Syntax

VOID
  NdisFReturnNetBufferLists(
    IN NDIS_HANDLE  NdisFilterHandle,
    IN PNET_BUFFER_LIST  NetBufferLists,
    IN ULONG  ReturnFlags
    );

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 that are to be returned to the underlying driver. The linked list can contain NET_BUFFER_LIST structures from multiple previous calls to the FilterReceiveNetBufferLists function.

• ReturnFlags
  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_RETURN_FLAGS_DISPATCH_LEVEL flag which; if set, indicates that the current IRQL is DISPATCH_LEVEL..

Return Value

None

Remarks

If the NDIS_RECEIVE_FLAGS_RESOURCES flag in the ReceiveFlags parameter that NDIS passed to the FilterReceiveNetBufferLists function was not set, the filter driver must call the NdisFReturnNetBufferLists function to return the NET_BUFFER_LIST structures and associated data. After the filter driver calls NdisFReturnNetBufferLists, NDIS returns the data to the underlying driver.

Requirements

See Also

Reference

NDIS Functions for Filter Drivers
FilterAttach
FilterReceiveNetBufferLists
NET_BUFFER
NET_BUFFER_LIST