FWPS_CALLOUT0-Struktur (fwpsk.h)

Artikel
02/29/2024

Die FWPS_CALLOUT0-Struktur definiert die Daten, die für einen Legendentreiber erforderlich sind, um eine Legende bei der Filter-Engine zu registrieren.

Beachten SieFWPS_CALLOUT0 die spezifische Version von FWPS_CALLOUT ist, die in Windows Vista und höher verwendet wird. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielgruppenspezifische Windows-Versionen . Für Windows 8 ist FWPS_CALLOUT2 verfügbar. Für Windows 7 ist FWPS_CALLOUT1 verfügbar.

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;

Member

calloutKey

Eine vom Legendentreiber definierte GUID , die die Legende eindeutig identifiziert.

flags

Flags, die beschriftungsspezifische Parameter angeben. Mögliche Flags sind:

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

Ein Legendentreiber kann dieses Flag angeben, wenn eine Legende registriert wird, die auf einer Ebene hinzugefügt wird, die Datenflüsse unterstützt. Wenn dieses Flag angegeben ist, ruft die Filter-Engine die Legendenfunktion klassifizierenFn0 des Legendentreibers nur auf, wenn dem Datenfluss ein Kontext zugeordnet ist. Ein Legendentreiber ordnet einen Kontext einem Datenfluss zu, indem er die Funktion FwpsFlowAssociateContext0 aufruft .

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

Ein Legendentreiber gibt dieses Flag an, um anzugeben, dass die Legendenfunktion klassifizierenFn0 des Legendentreibers nicht durch das Auslagern der Netzwerkdatenverarbeitung in ausladende Netzwerkschnittstellenkarten (NICs) beeinträchtigt wird. Wenn dieses Flag nicht angegeben ist, wird die Auslagerung der Netzwerkdatenverarbeitung für den gesamten Datenverkehr deaktiviert, der von Filtern verarbeitet wird, die die Legende für die Aktion des Filters angeben.

classifyFn

Ein Zeiger auf die Legendenfunktion klassifizierenFn0 des Legendentreibers. Die Filter-Engine ruft diese Funktion auf, wenn Netzwerkdaten vorhanden sind, die von der Legende verarbeitet werden sollen.

notifyFn

Ein Zeiger auf die Funktion notifyFn0 des Legendentreibers. Die Filter-Engine ruft diese Funktion auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Legende zugeordnet sind.

flowDeleteFn

Ein Zeiger auf die Legendenfunktion flowDeleteFn des Legendentreibers. Die Filter-Engine ruft diese Funktion immer dann auf, wenn ein Von der Legende verarbeiteter Datenfluss beendet wird.

Wenn ein Legendentreiber den Datenflüssen, die die Legende verarbeitet, keinen Kontext ordnet, sollte dieser Member auf NULL festgelegt werden.

Hinweise

Ein Legendentreiber übergibt einen Zeiger auf eine initialisierte FWPS_CALLOUT0-Struktur an die Funktion FwpsCalloutRegister0 , wenn er eine Legende bei der Filter-Engine registriert.

Eine Legende kann das FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW-Flag nur für Verbindungen festlegen, für die der Treiber an Streamüberprüfungen interessiert ist. Diese Beschriftung wird bei allen anderen Verbindungen ignoriert. Die Leistung wird verbessert, und der Treiber muss keine unnötigen Zustandsdaten verwalten.