MiniportQueryOffload routine

The MiniportQueryOffload function queries previously offloaded TCP chimney state objects.

Syntax


W_QUERY_OFFLOAD_HANDLER MiniportQueryOffload;

VOID MiniportQueryOffload(
  _In_     NDIS_HANDLE MiniportAdapterContext,
  _Inout_  PNDIS_MINIPORT_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, out]

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 that is being queried.

Return value

None

Remarks

The MiniportQueryOffload function can query any TCP chimney state that has been offloaded to the offload target.

The MiniportQueryOffload function stores the OffloadBlockList pointer and then returns. The offload target always completes the query operation asynchronously by calling the NdisMQueryOffloadStateComplete function. The OffloadBlockList pointer points to an NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure that can either be a stand-alone structure or the root node in an offload state tree. The state tree is valid until the offload target calls the NdisMQueryOffloadStateComplete function.

After returning from the MiniportQueryOffload function, the miniport driver fills in the offload state structure that is associated with each NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure in the state tree pointed to by the OffloadBlockList pointer. To each of these offload state structures, the miniport driver writes the current value of each variable in the structure.

Before calling the NdisMQueryOffloadStateComplete function, the offload target must write either of the following NDIS_STATUS values to the Status member of each NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure in the state tree:

  • NDIS_STATUS_SUCCESS

    The offload target successfully queried the state objects.

  • NDIS_STATUS_FAILURE

    The query operation did not succeed. The host stack will terminate the state objects that could not be queried.

Requirements

Header

Ndischimney.h (include Ndischimney.h)

IRQL

Any level

See also

MiniportInitializeEx
NDIS_MINIPORT_OFFLOAD_BLOCK_LIST
NdisMSetMiniportAttributes
NdisMQueryOffloadStateComplete

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft