FWPS_CALLOUT2 Struktur (fwpsk.h)
Die FWPS_CALLOUT2 Struktur definiert die Daten, die für einen Legendentreiber erforderlich sind, um eine Legende mit dem Filtermodul zu registrieren.
Syntax
typedef struct FWPS_CALLOUT2_ {
GUID calloutKey;
UINT32 flags;
FWPS_CALLOUT_CLASSIFY_FN2 classifyFn;
FWPS_CALLOUT_NOTIFY_FN2 notifyFn;
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT2;
Angehörige
calloutKey
Eine beschriftungstreiberde GUID, die die Legende eindeutig identifiziert.
flags
Flags, die Beschriftungsspezifische Parameter angeben. Mögliche Kennzeichen sind:
| Wert | Bedeutung |
|---|---|
|
Ein Legendentreiber kann dieses Kennzeichen angeben, wenn eine Legende registriert wird, die auf einer Ebene hinzugefügt wird, die Datenflüsse unterstützt. Wenn dieses Kennzeichen angegeben ist, ruft das Filtermodul die klassifizierenFn2 Popupfunktion nur auf, wenn ein Kontext mit dem Datenfluss verknüpft ist. Ein Beschriftungstreiber ordnet einen Kontext einem Datenfluss zu, indem die FwpsFlowAssociateContext0--Funktion aufgerufen wird. |
|
Ein Beschriftungstreiber gibt dieses Kennzeichen an, um anzugeben, dass die klassifizierenFn2 Beschriftungsfunktion durch das Entladen der Netzwerkdatenverarbeitung auf offloadfähige Netzwerkschnittstellenkarten (NICs) nicht beeinträchtigt wird. Wenn dieses Kennzeichen nicht angegeben ist, wird das Entladen der Netzwerkdatenverarbeitung für den gesamten Datenverkehr deaktiviert, der von allen Filtern verarbeitet wird, die die Legende für die Aktion des Filters angeben. |
|
Ein Popuptreiber gibt dieses Kennzeichen an, um anzugeben, dass es Benachrichtigungen zu Objekten und Filtern empfangen kann, die in einer Transaktion hinzugefügt werden. Das Filtermodul sendet die Benachrichtigung, nachdem die Transaktion zugesichert wurde. |
|
Ein Popuptreiber gibt dieses Kennzeichen an, um anzugeben, dass es eine dynamische Datenstromüberprüfung von Datenflüssen auf Datenstromebene durchführen kann. Siehe Stream Inspection. |
|
Ein Popuptreiber gibt dieses Kennzeichen an, um sich selbst zu registrieren, wenn ein vorhandener Socketvorgang neu klassifiziert wird. |
|
Reserviert für die Systemverwendung. Legendentreiber sollten dieses Flag ignorieren. |
|
Ein Beschriftungstreiber gibt dieses Kennzeichen an, um anzugeben, dass die Legende TCP-Empfangssegmente (RSC) mit großen Paketen von bis zu 64K unterstützt. Wenn dieses Flag nicht angegeben ist und eine Legende registriert ist, wird RSC für den gesamten Datenverkehr deaktiviert, der von allen Filtern verarbeitet wird, die die Legende für die Aktion des Filters angeben. |
|
Ein Legendentreiber gibt dieses Kennzeichen beim Registrieren einer Legende an, die auf Ebene 2 hinzugefügt wird, um anzugeben, dass die klassifizierenFn2 Legendenfunktion mehrere verkettete NET_BUFFER_LIST Strukturen klassifizieren kann. Weitere Informationen finden Sie unter Using Layer 2 Filtering.
Vorsicht
Wenn ein Beschriftungstreiber dieses Kennzeichen festlegt, kann es nicht die folgenden Funktionen verwenden, um NET_BUFFER_LISTs zu ändern.
Mit diesem Flagsatz gibt FwpsAllocateCloneNetBufferList0 immer einen INVALID_PARAMETER Fehler zurück. Dies kann unerwartet dazu führen, dass ein Drittanbieter-Beschriftungstreiber die Referenzanzahl von NET_BUFFER_LISTs nicht verwaltet, wodurch Sende- und Empfangsvorgänge beendet werden. |
|
Ein Legendentreiber gibt dieses Kennzeichen an, um anzugeben, dass die Legende UDP-Segmentierungs offload (USO) mit Paketen unterstützt, die größer als die MTU des Netzwerkmediums sind. Wenn dieses Flag nicht angegeben ist und eine Legende registriert ist, wird USO für den gesamten Datenverkehr deaktiviert, der von allen Filtern verarbeitet wird, die die Legende für die Aktion des Filters angeben. Hinweis: Die früheste Version, auf der dieses Flag unterstützt wird, ist Windows Insider Preview, Version 10.0.25876. |
|
Ein Popuptreiber gibt dieses Kennzeichen an, um anzugeben, dass die Legende UDP-Empfangs offload (URO) mit großen Paketen von bis zu 64K unterstützt. Wenn dieses Kennzeichen nicht angegeben ist und eine Legende registriert ist, wird URO für den gesamten Datenverkehr deaktiviert, der von allen Filtern verarbeitet wird, die die Legende für die Aktion des Filters angeben. Hinweis: Wenn dieses Flag angegeben ist, dürfen Legenden keine klonen und eingehenden URO-Pakete erneut auswerfen. |
classifyFn
Ein Zeiger auf die klassifizierenFn2 Legendenfunktion des Popuptreibers. Das Filtermodul ruft diese Funktion immer dann auf, wenn es Netzwerkdaten gibt, die von der Legende verarbeitet werden sollen.
notifyFn
Ein Zeiger auf die notifyFn2-Funktion des Popuptreibers. Das Filtermodul ruft diese Funktion auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind.
flowDeleteFn
Ein Zeiger auf die flowDeleteFn Legendenfunktion des Popuptreibers. Das Filtermodul ruft diese Funktion immer dann auf, wenn ein vom Popup verarbeiteter Datenfluss beendet wird.
Wenn ein Beschriftungstreiber keinen Kontext mit den Datenflüssen verknüpft, die von der Legende verarbeitet werden, sollte dieses Element auf NULL festgelegt werden.
Bemerkungen
Ein Legendentreiber übergibt einen Zeiger an eine initialisierte FWPS_CALLOUT2 Struktur an die FwpsCalloutRegister2 Funktion, wenn eine Legende mit dem Filtermodul registriert wird.
Eine Legende kann das FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW Flag nur für Verbindungen festlegen, für die der Treiber an der Durchführung von Datenstromüberprüfungen interessiert ist. Diese Legende wird für alle anderen Verbindungen ignoriert. Die Leistung wird verbessert, und der Treiber muss keine unnötigen Zustandsdaten beibehalten.
Diese Struktur ist im Wesentlichen identisch mit der vorherigen Version, FWPS_CALLOUT1. Die einzigen Unterschiede bestehen darin, dass die Member dieser Version die aktualisierten Versionen der Legendenfunktionszeiger speichern, und zusätzliche Flags sind für Popuptreiber verfügbar, die festgelegt werden sollen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Header- | fwpsk.h (include Fwpsk.h) |