MiniportUpdateOffload routine

The MiniportUpdateOffload function updates previously offloaded TCP chimney state objects.

Syntax


W_UPDATE_OFFLOAD_HANDLER MiniportUpdateOffload;

VOID MiniportUpdateOffload(
  _In_  NDIS_HANDLE MiniportAdapterContext,
  _In_  PNDIS_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{ ... }

Parameters

MiniportAdapterContext [in]

The handle to an offload target-allocated context area in which the offload target maintains state information about this instance of the adapter. The offload target provided this handle to NDIS when it called NdisMSetMiniportAttributes from its MiniportInitializeEx function.

OffloadBlockList [in]

A pointer to an NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure, which can be the root of a linked list of such structures. These structures identify the offloaded state objects that are being updated. Only cached variables are updated.

Return value

None

Remarks

Only cached variables are updated.

The MiniportUpdateOffload function stores the MiniportAdapterContext handle and the OffloadBlockList pointer and then returns. The offload target always completes the update operation asynchronously by calling the NdisMUpdateOffloadComplete function. The OffloadBlockList pointer points to an NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure that can either be a stand-alone structure or the root block list in an offload state tree that contains multiple NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structures. Such block lists, as well as any offload state structures that are associated with them, are valid until the miniport driver calls the NdisMUpdateOffloadComplete function.

Before the MiniportUpdateOffload function returns, the offload target uses the offload state tree passed to the MiniportUpdateOffload function to update offloaded state:

  • The offload target copies the variable values from any state structures in the tree to the corresponding offloaded state objects. Only CACHED variables are updated.

  • The tree might indicate that path-to-neighbor links must be updated. For more information, see Linking Path State Objects to a New Neighbor State Object. In this case, the offload target must update its internal representation of offloaded state to reflect the updated links.

Requirements

Header

Ndischimney.h (include Ndischimney.h)

IRQL

Any level

See also

MiniportInitializeEx
NDIS_MINIPORT_OFFLOAD_BLOCK_LIST
NdisMSetMiniportAttributes
NdisMUpdateOffloadComplete

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft