NdisReturnNetBufferLists function (ndis.h)

NDIS drivers call the NdisReturnNetBufferLists function to release ownership of a list of NET_BUFFER_LIST structures, along with the associated NET_BUFFER structures and network data.

Syntax

void NdisReturnNetBufferLists(
  [in] NDIS_HANDLE      NdisBindingHandle,
  [in] PNET_BUFFER_LIST NetBufferLists,
  [in] ULONG            ReturnFlags
);

Parameters

[in] NdisBindingHandle

A handle that identifies the target adapter. This handle was returned by a previous call to the NdisOpenAdapterEx function. All of the NET_BUFFER_LIST structures that are specified in this call must be from the binding that this handle identifies.

[in] 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 ProtocolReceiveNetBufferLists function.

[in] 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. For more information about this flag, see Dispatch IRQL Tracking.

Return value

None

Remarks

If the NDIS_RECEIVE_FLAGS_RESOURCES flag in the ReceiveFlags parameter that NDIS passed to the ProtocolReceiveNetBufferLists function was not set, the protocol driver must call NdisReturnNetBufferLists to return the NET_BUFFER_LIST structures and associated data. After the protocol driver calls NdisReturnNetBufferLists, NDIS calls the underlying miniport driver's MiniportReturnNetBufferLists function.

Requirements

See also

NET_BUFFER

NET_BUFFER_LIST

NdisOpenAdapterEx