FWPS_CALLOUT1 Struktur (fwpsk.h)
Die FWPS_CALLOUT1 Struktur definiert die Daten, die für einen Legendentreiber erforderlich sind, um eine Legende mit dem Filtermodul zu registrieren.
Syntax
typedef struct FWPS_CALLOUT1_ {
GUID calloutKey;
UINT32 flags;
FWPS_CALLOUT_CLASSIFY_FN1 classifyFn;
FWPS_CALLOUT_NOTIFY_FN1 notifyFn;
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT1;
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 klassifizierenFn1 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 klassifizierenFn1 Legendenfunktion 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. |
classifyFn
Ein Zeiger auf die klassifizierenFn1 Legendenfunktion des Legendentreibers. Das Filtermodul ruft diese Funktion immer dann auf, wenn es Netzwerkdaten gibt, die von der Legende verarbeitet werden sollen.
notifyFn
Ein Zeiger auf die notifyFn1-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 die Legende verarbeitet, sollte dieses Element auf NULL-festgelegt werden.
Bemerkungen
Ein Popuptreiber übergibt einen Zeiger an eine initialisierte FWPS_CALLOUT1 Struktur an die FwpsCalloutRegister1 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_CALLOUT0. 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 7. |
| Header- | fwpsk.h (include Fwpsk.h) |