FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0 Rückruffunktion (fwpsk.h)

Artikel
02/26/2024

Die Filter-Engine ruft die Beschriftungsfunktion vSwitchFilterEngineReorderNotifyRn (FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0) auf, um den Legendentreiber über Ereignisse zu benachrichtigen, die der Neuanordnung der Filter-Engine des virtuellen Switches zugeordnet sind.

Beachten SieFWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0 eine bestimmte Version von FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK ist. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

Syntax

FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0 FwpsVswitchFilterEngineReorderCallback0;

NTSTATUS FwpsVswitchFilterEngineReorderCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           BOOLEAN isInRequiredPosition,
  [in]           const NDIS_ENUM_FILTERS *vSwitchExtensionLwfList
)
{...}

Parameter

[in, optional] notifyContext

Ein Zeiger auf einen Kontext, der vom Legendentreiber bereitgestellt wird. Der Treiber hat diesen Zeiger an den notifyContext-Parameter der Funktion FwpsvSwitchEventsSubscribe0 übergeben. Dieser Parameter ist optional und kann NULL sein.

[in] completionContext

Ein Zeiger auf einen Vervollständigungskontext, der vom Legendentreiber bereitgestellt wird. Dieser Parameter ist optional und kann NULL sein.

[in] isInRequiredPosition

Ein BOOLEAN-Wert, der auf TRUE festgelegt ist, wenn sich der Filter an der erforderlichen Position im Filterstapel befindet, oder FALSE, falls nicht.

[in] vSwitchExtensionLwfList

Eine NDIS_ENUM_FILTERS-Struktur , die eine Liste der NDIS-Filtertreiber der Virtuellen Switch-Erweiterung angibt.

Rückgabewert

Beschriftung einer Legende

FWPS_VSWITCH_FILTER_ENGINE_REORDER_CALLBACK0 Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Legendentreiber akzeptiert die Benachrichtigung von der Filter-Engine.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Legendentreiber registriert eine

vSwitchFilterEngineReorderNotifyRn-Funktion durch Aufrufen
die FwpsvSwitchEventsSubscribe0-Funktion .

Standardmäßig wird die Erweiterung des virtuellen WFP-Switches als erste Filtererweiterung am Eingang des virtuellen Switches positioniert. (Daher ist es auch die letzte Erweiterung beim ausgehenden virtuellen Switch. Dies ist in der Regel die beste Position, da die WFP-Erweiterung Pakete abfangen kann, bevor andere Erweiterungen sie beim Eingang ändern können. Darüber hinaus kann die WFP-Erweiterung Pakete abfangen, nachdem alle Paketänderungen beim ausgehenden Datenverkehr vorgenommen wurden.

Da ein Administrator jedoch alle Erweiterungen des virtuellen Switches derselben Klasse neu anordnen kann, kann die WFP-Erweiterung von der Standardposition aus neu angeordnet werden. Nach einer Neuanordnung können die Filter eines WFP-Clients umgangen werden und müssen möglicherweise angepasst werden.

Wenn der vSwitchFilterEngineReorderNotifyRn-Rückruf registriert ist, wird der Legendentreiber benachrichtigt, wenn eine Neuanordnung des virtuellen Switches erfolgt. Der Legendentreiber empfängt eine NDIS_ENUM_FILTERS-Struktur mit einer sortierten Liste der aktuellen Erweiterungen virtueller Switches im vSwitchExtensionLwfList-Parameter .

Wenn die Erweiterungen des virtuellen Switches neu angeordnet werden, wird die WFP-Erweiterung angehalten (siehe FilterPause) und neu gestartet (siehe FilterRestart). Über den FilterRestart-Aufruf des WFP-Filters ruft der WFP-Filtertreiber die NdisEnumerateFilterModules-Funktion auf, um eine geordnete Liste von Virtuellen Switch-Erweiterungsfiltern zu erhalten. Wenn sich die WFP-Erweiterung nicht an der Standardposition befindet, benachrichtigt der Filtertreiber die Legendentreiber.

Ein Legendentreiber kann keine STATUS_PENDING von vSwitchFilterEngineReorderNotifyRn zurückgeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Windows
Kopfzeile	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL