UPDATE_OFFLOAD_COMPLETE_HANDLER callback function (ndischimney.h)

[The TCP chimney offload feature is deprecated and should not be used.]

NDIS calls a protocol driver's or intermediate driver's ProtocolUpdateOffloadComplete function to complete an update offload operation that the driver previously initiated by calling the NdisUpdateOffload function.

Syntax

UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;

void UpdateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parameters

[in] ProtocolBindingContext

A handle to a context area allocated by the protocol driver. The driver maintains the per binding context information in this context area. The driver supplied this handle to NDIS when the driver called the NdisOpenAdapterEx function

[in] OffloadBlockList

A pointer to an NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST structure that can be a stand-alone structure or the root of a linked list of such structures. These structures identify the state that was updated or that was attempted to be updated.

Return value

None

Remarks

In response to an underlying offload target's or intermediate driver's call to the NdisMUpdateOffloadComplete function, NDIS calls a protocol or intermediate driver's ProtocolUpdateOffloadComplete function.

An intermediate driver must propagate the completion of the update offload operation to the driver above it by calling NdisMUpdateOffloadComplete. For more information, see Propagating the Completion of a State-Manipulation Operation.

From the NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST structure that was passed to its ProtocolUpdateOffloadComplete function, the intermediate driver constructs an NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure. For more information, see Reusing an NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Structure. When calling the NdisMUpdateOffloadComplete function, the intermediate driver passes a pointer (the OffloadBlockList parameter) to this newly constructed NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure.

Requirements

Requirement Value
Target Platform Windows
Header ndischimney.h (include Ndischimney.h)

See also

MiniportUpdateOffload

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST

NdisMUpdateOffloadComplete

NdisOpenAdapterEx

NdisUpdateOffload