FwpsCompleteOperation0 function (fwpsk.h)

The FwpsCompleteOperation0 function is called by a callout to resume packet processing that was suspended pending completion of another operation.

Syntax

void FwpsCompleteOperation0(
  [in]           HANDLE           completionContext,
  [in, optional] PNET_BUFFER_LIST netBufferList
);

Parameters

[in] completionContext

A completion context handle that was previously created by a call to the FwpsPendOperation0 function.

[in, optional] netBufferList

A pointer to a NET_BUFFER_LIST structure that describes the packet data for which processing has been suspended pending completion of another operation.

Return value

None

Remarks

When the callout is ready to resume packet processing after operations on the packet were suspended by a call to FwpsPendOperation0, the callout should call the FwpsCompleteOperation0 function, passing it the completionContext parameter value from FwpsPendOperation0 and the net buffer list data that describes the packet.

To complete a connection that was previously pended at the FWPS_LAYER_ALE_AUTH_RECV_ACCEPT_Xxx layer, the callout driver must reinject the packet that was cloned at that layer, and the callout should also call FwpsCompleteOperation0.

Pended connections are authenticated again after the FwpsCompleteOperation0 function executes. TCP connections, if allowed, are created by completing the handshake operation, but non-TCP connections just create state entries. Any pended packet data is flushed from memory when the FwpsPendOperation0 function completes, so an application will have to retransmit those packets after FwpsCompleteOperation0 executes. The callout could buffer such data and reinject the data on the application's behalf.

Requirements

See also

FwpsPendOperation0

NET_BUFFER_LIST