FWPS_STREAM_CALLOUT_IO_PACKET0 Struktur (fwpsk.h)
Die FWPS_STREAM_CALLOUT_IO_PACKET0 Struktur beschreibt die vom Filtermodul übergebenen Daten an die klassifizierenFn Legendenfunktion beim Filtern eines Datenstroms.
Syntax
typedef struct FWPS_STREAM_CALLOUT_IO_PACKET0_ {
FWPS_STREAM_DATA0 *streamData;
SIZE_T missedBytes;
UINT32 countBytesRequired;
SIZE_T countBytesEnforced;
FWPS_STREAM_ACTION_TYPE streamAction;
} FWPS_STREAM_CALLOUT_IO_PACKET0;
Angehörige
streamData
Ein Zeiger auf eine FWPS_STREAM_DATA0 Struktur, der den Teil des Datenstroms beschreibt, der für die klassifizierenFn Beschriftungsfunktion des Legendentreibers zur Verarbeitung verfügbar ist.
missedBytes
Die Anzahl der Bytes im Datenstrom, die seit dem letzten Aufruf des Popuptreibers klassifizierenFn Popupfunktion fehlen. Dieses Element ist nicht null, wenn ein Filter mit höherer Gewichtung im Filtermodul verhindert hat, dass die Legendenfunktion des Popuptreibers "klassifizierenFn" einen Teil des Datenstroms verarbeitet.
countBytesRequired
Ein Wert, der durch die klassifizierenFn Legendenfunktion einer Legende festgelegt wird. Dieser Wert gibt an, wie viele zusätzliche Byte von Datenstromdaten von der Popupfunktion benötigt werden, wenn der streamAction Member auf FWPS_STREAM_ACTION_NEED_MORE_DATAfestgelegt wird. Das Filtermodul wartet, bis es mindestens diese vielen zusätzlichen Datenstromdaten empfängt, bevor die Popupfunktion des Popuptreibers erneut aufgerufen wird.
Wenn die klassifizierenFn eines Popups Legendenfunktion das streamAction Element auf einen anderen Wert als FWPS_STREAM_ACTION_NEED_MORE_DATAfestlegt, sollte dieses Element auf Null festgelegt werden.
countBytesEnforced
Ein Wert, der durch die klassifizierenFn Legendenfunktion einer Legende festgelegt wird. Dieser Wert gibt die Anzahl der führenden Byte von Daten im Teil des Datenstroms an, auf den die vom streamAction Member angegebene Aktion oder die von der Legendenfunktion zurückgegebene Aktion angewendet wird. Alle verbleibenden Daten im Datenstrompuffer werden erneut an den Legendentreiber übergeben, wenn das Filtermodul die Popupfunktion des Popuptreibers "klassifizierenFn" aufruft.
streamAction
Ein FWPS_STREAM_ACTION_TYPE Wert, der durch die klassifizierenFn Legendenfunktion eines Popups festgelegt wird, die die Aktion angibt, die auf den Datenstrom angewendet werden soll. Diese Aktion ist unabhängig von der Aktion, die von der Legendenfunktion zurückgegeben wird. Die Popupfunktion "klassifizierenFn" eines Popups legt dieses Element auf einen der folgenden Elemente fest:
FWPS_STREAM_ACTION_NONE
Es ist keine streamspezifische Aktion erforderlich.
FWPS_STREAM_ACTION_ALLOW_CONNECTION
Gibt an, dass alle zukünftigen Datensegmente, die zu einem Fluss gehören, zulässig sind. In diesem Fall beendet WFP die Klassifizierung von Datensegmenten an die Legende und versucht, den Fluss auf die Hardware zu entladen, sodass kein mehr Inspektionsaufwand entsteht.
FWPS_STREAM_ACTION_NEED_MORE_DATA
Für die Legendenfunktion sind weitere Datenstromdaten erforderlich.
FWPS_STREAM_ACTION_DROP_CONNECTION
Die Streamverbindung sollte gelöscht werden. Die klassifizierenFn Popupfunktion einer Legende sollte nur das streamAction-Element diesem Wert festlegen, wenn der action.type Member der FWPS_FILTER0 Struktur, die das Filtermodul an die Legendenfunktion des Popuptreibers übergeben hat, den Wert FWP_ACTION_CALLOUT_UNKNOWNenthält. Wenn die Popupfunktion "klassifizierenFn" eines Popups den streamAction Member auf diesen Wert festlegt, wenn der action.type Member der FWPS_FILTER0-Struktur den Wert FWP_ACTION_CALLOUT_INSPECTIONenthält, wird die Verbindung nicht gelöscht.
FWPS_STREAM_ACTION_DEFER
Die Verarbeitung der Datenstromdaten wird zurückgestellt, bis der Legendentreiber die FwpsStreamContinue0-Funktion aufruft. Diese Aktion kann nur für einen eingehenden Datenstrom festgelegt werden.
Das Zurückstellen eines eingehenden Datenstroms führt dazu, dass der Netzwerkstapel die Bestätigung der vom Absender empfangenen Daten beendet. Dies führt zu einer Verringerung der Größe des gleitenden TCP-Fensters. Ein Popuptreiber kann dieses Verhalten verwenden, um die Ablaufsteuerung zu implementieren, um die eingehende Datenrate zu verlangsamen.
Der wert FWPS_STREAM_ACTION_TYPE_MAX ist ein Maximalwert für Testzwecke.
Wenn die klassifizierenFn Legendenfunktion eines Popups dieses Element auf einen anderen Wert als FWPS_STREAM_ACTION_NONEfestlegt, wird die von der Legendenfunktion zurückgegebene Aktion vom Filtermodul ignoriert.
Bemerkungen
Das Filtermodul übergibt einen Zeiger an eine FWPS_STREAM_CALLOUT_IO_PACKET0 Struktur an die klassifizierenFn Legendenfunktion als layerData- parameter beim Filtern eines Datenstroms.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows Vista. |
| Header- | fwpsk.h (include Fwpsk.h) |