FWPS_CALLOUT0 Struktur (fwpsk.h)
Die FWPS_CALLOUT0 Struktur definiert die Daten, die für einen Legendentreiber erforderlich sind, um eine Legende mit dem Filtermodul zu registrieren.
Syntax
typedef struct FWPS_CALLOUT0_ {
GUID calloutKey;
UINT32 flags;
FWPS_CALLOUT_CLASSIFY_FN0 classifyFn;
FWPS_CALLOUT_NOTIFY_FN0 notifyFn;
FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT0;
Angehörige
calloutKey
Eine beschriftungstreiberde GUID, die die Legende eindeutig identifiziert.
flags
Flags, die Beschriftungsspezifische Parameter angeben. Mögliche Kennzeichen sind:
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW
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 Flag angegeben ist, ruft das Filtermodul die klassifizierenFn0 Legendenfunktion nur dann auf, wenn dem Datenfluss ein Kontext zugeordnet ist. Ein Beschriftungstreiber ordnet einen Kontext einem Datenfluss zu, indem die FwpsFlowAssociateContext0--Funktion aufgerufen wird.
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD
Ein Beschriftungstreiber gibt dieses Kennzeichen an, um anzugeben, dass die klassifizierenFn0 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.
classifyFn
Ein Zeiger auf die klassifizierenFn0 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 notifyFn0-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_CALLOUT0 Struktur an die FwpsCalloutRegister0-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.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows Vista. |
| Header- | fwpsk.h (include Fwpsk.h) |