FwpsStreamContinue0 function (fwpsk.h)

  • Article

The FwpsStreamContinue0 function resumes the processing of an inbound data stream that was previously deferred.

Note  FwpsStreamContinue0 is a specific version of FwpsStreamContinue. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.
 

Syntax

NTSTATUS FwpsStreamContinue0(
  [in] UINT64 flowId,
  [in] UINT32 calloutId,
  [in] UINT16 layerId,
  [in] UINT32 streamFlags
);

Parameters

[in] flowId

A run-time identifier that specifies the data flow that is being resumed. The run-time identifier for a data flow is provided to a callout driver through the FWPS_METADATA_FIELD_FLOW_HANDLE metadata value that the filter engine provided to the callout driver's classifyFn callout function.

[in] calloutId

The run-time identifier for the callout that deferred the inbound data stream. This identifier was returned when the callout driver called either the FwpsCalloutRegister0 or FwpsCalloutRegister1 functions to register the callout with the filter engine.

[in] layerId

The run-time identifier for the filtering layer at which the data stream is being processed. This value must be either FWPS_LAYER_STREAM_V4 or FWPS_LAYER_STREAM_V6. The run-time identifier for the layer at which the data stream is being processed is provided to a callout in the layerId member of the FWPS_INCOMING_VALUES0 structure that the filter engine passed to the callout driver's classifyFn callout function.

[in] streamFlags

Flags that specify characteristics of the inbound data stream that is being resumed. A callout driver should specify the same stream flags that were set in the streamFlags member of the FWPS_STREAM_DATA0 structure that the filter engine passed to the callout driver's classifyFn callout function when the callout deferred the data stream.

Return value

The FwpsStreamContinue0 function returns one of the following NTSTATUS codes.

Return code Description
STATUS_SUCCESS
 Processing of the data stream was successfully resumed.
Other status codes
 An error occurred.

Remarks

A callout driver calls the FwpsStreamContinue0 function to resume processing an inbound data stream that was previously deferred. A data stream is deferred when a callout's classifyFn callout function sets the streamAction member of the FWPS_STREAM_CALLOUT_IO_PACKET0 structure to FWPS_STREAM_ACTION_DEFER. The FwpsStreamContinue0 function cannot be called from within a callout's classifyFn context.

Requirements

Requirement Value
Minimum supported client Available starting with Windows Vista.
Target Platform Universal
Header fwpsk.h (include Fwpsk.h)
Library Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

See also

FWPS_INCOMING_VALUES0

FWPS_STREAM_CALLOUT_IO_PACKET0

FwpsCalloutRegister0

FwpsCalloutRegister1

classifyFn