FWPS_CALLOUT0 Struktur (fwpsk.h)

Die FWPS_CALLOUT0 Struktur definiert die Daten, die für einen Callouttreiber erforderlich sind, um ein Callout mit dem Filtermodul zu registrieren.

HinweisFWPS_CALLOUT0 ist die spezifische Version von FWPS_CALLOUT , die in Windows Vista und höher verwendet wird. Weitere Informationen finden Sie unter WFP Version-Independent Namen und Zielspezifischer Versionen von Windows . 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 Beschriftungstreiber-definierte GUID , die die Beschriftung eindeutig identifiziert.

flags

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

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

Ein Callouttreiber kann dieses Flag angeben, wenn ein Callout registriert wird, das auf einer Ebene hinzugefügt wird, die Datenflüsse unterstützt. Wenn dieses Flag angegeben wird, ruft das Filtermodul die klassifizierenFn0-Funktion des Callouttreibers nur auf, wenn ein Kontext mit dem Datenfluss verknüpft ist. Ein Callouttreiber verknüpft einen Kontext mit einem Datenfluss, indem die Funktion FwpsFlowAssociateContext0 aufgerufen wird.

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

Ein Callout-Treiber gibt dieses Flag an, um anzugeben, dass die KlassifizierenFn0-Funktion des Callout-Treibers unberührt ist, indem die Netzwerkdatenverarbeitung deaktiviert wird, um netzwerkfähige Netzwerkschnittstellenkarten (NICs) zu deaktivieren. Wenn dieses Flag nicht angegeben ist, wird die Ausladung der Netzwerkdatenverarbeitung für alle Datenverkehr deaktiviert, die von allen Filtern verarbeitet werden, die das Callout für die Aktion des Filters angeben.

classifyFn

Ein Zeiger auf die Klassifikationsfunktion des CallouttreibersFn0 . Das Filtermodul ruft diese Funktion auf, wenn Netzwerkdaten vom Callout verarbeitet werden sollen.

notifyFn

Ein Zeiger auf die Benachrichtigungsfunktion des Callouttreibers. Das Filtermodul ruft diese Funktion auf, um den Callouttreiber über Ereignisse zu benachrichtigen, die dem Callout zugeordnet sind.

flowDeleteFn

Ein Zeiger auf die FlowDeleteFn-Funktion des Callouttreibers. Das Filtermodul ruft diese Funktion auf, wenn ein Datenfluss, der durch das Callout verarbeitet wird, beendet wird.

Wenn ein Callouttreiber keinen Kontext mit den Datenflüssen verknüpft, die die Callout-Prozesse verarbeiten, sollte dieses Element auf NULL festgelegt werden.

Bemerkungen

Ein Callouttreiber übergibt einen Zeiger an eine initialisierte FWPS_CALLOUT0 Struktur an die Funktion FwpsCalloutRegister0 , wenn er ein Callout mit dem Filtermodul registriert.

Ein Callout kann das FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW Flag nur für Verbindungen festlegen, auf denen der Treiber an der Ausführung von Streamüberprüfungen interessiert ist. Diese Beschriftung wird auf allen anderen Verbindungen ignoriert. Die Leistung wird verbessert, und der Treiber muss keine unnötigen Zustandsdaten beibehalten.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar ab Windows Vista.
Header fwpsk.h (enthalten Fwpsk.h)

Weitere Informationen

FWPS_CALLOUT1

FWPS_CALLOUT2

FwpsCalloutRegister0

klassifizierenFn0

flowDeleteFn

benachrichtigenFn0