FWPS_CALLOUT1-Struktur (fwpsk.h)
Die FWPS_CALLOUT1-Struktur definiert die Daten, die für einen Legendentreiber erforderlich sind, um eine Legende bei der Filter-Engine 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;
Member
calloutKey
Eine vom Legendentreiber definierte GUID , die die Legende eindeutig identifiziert.
flags
Flags, die beschriftungsspezifische Parameter angeben. Mögliche Flags sind:
| Wert | Bedeutung |
|---|---|
|
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 klassifizierenFn1 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 . |
|
Ein Legendentreiber gibt dieses Flag an, um anzugeben, dass die Legendenfunktion klassifizierenFn1 des Legendentreibers durch das Auslagern der Netzwerkdatenverarbeitung auf ausladende Netzwerkschnittstellenkarten (NICs) nicht 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. |
|
Ein Legendentreiber gibt dieses Flag an, um anzugeben, dass er Benachrichtigungen über Objekte und Filter empfangen kann, die innerhalb einer Transaktion hinzugefügt werden. Die Filter-Engine sendet die Benachrichtigung nach dem Commit der Transaktion. |
|
Ein Legendentreiber gibt dieses Flag an, um anzugeben, dass er eine dynamische Streamüberprüfung von Datenflüssen auf Streamebene durchführen kann. Weitere Informationen finden Sie unter Stream Inspektion. |
|
Ein Legendentreiber gibt dieses Flag an, um sich für den Aufruf zu registrieren, wenn ein vorhandener Socketvorgang neu klassifiziert wird. |
classifyFn
Ein Zeiger auf die Legendentreiberfunktion klassifizierenFn1 . Die Filter-Engine ruft diese Funktion auf, wenn Netzwerkdaten vorhanden sind, die von der Legende verarbeitet werden sollen.
notifyFn
Ein Zeiger auf die Funktion notifyFn1 des Callouttreibers. 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_CALLOUT1-Struktur an die Funktion FwpsCalloutRegister1 , wenn er eine Legende beim Filtermodul 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.
Diese Struktur ist im Wesentlichen mit der vorherigen Version identisch, FWPS_CALLOUT0. Der einzige Unterschied besteht darin, dass die Member dieser Version die aktualisierten Versionen der Legendenfunktionszeiger speichern und zusätzliche Flags für Legendentreiber zum Festlegen verfügbar sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 7. |
| Kopfzeile | fwpsk.h (include fwpsk.h) |