FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
02/29/2024

Il motore di filtro chiama la funzione di callout vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) per notificare al driver callout gli eventi associati all'interfaccia del commutatore virtuale.

NotaFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 è una versione specifica di FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

Sintassi

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;

NTSTATUS FwpsVswitchInterfaceEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}

Parametri

[in, optional] notifyContext

Puntatore a un contesto fornito dal driver del callout. Il driver ha passato questo puntatore al parametro notifyContext della funzione FwpsvSwitchEventsSubscribe0 . Questo parametro è facoltativo e può essere NULL.

[in] completionContext

Puntatore a un contesto di completamento fornito dal driver del callout. Questo parametro è facoltativo e può essere NULL.

[in] eventType

Tipo di evento del commutatore virtuale specificato come uno dei valori di enumerazione FWPS_VSWITCH_EVENT_TYPE . Per altre informazioni, vedere la sezione Osservazioni.

[in] vSwitch

Puntatore a una struttura NDIS_SWITCH_PARAMETERS che contiene informazioni su un commutatore virtuale.

Nota Le informazioni nella struttura NDIS_SWITCH_PARAMETERS riflettono lo stato iniziale del commutatore virtuale, non necessariamente lo stato corrente. In particolare, i membri NumSwitchPorts e IsActive potrebbero avere il valore iniziale zero, a meno che non sia stato attivato un evento PnP del commutatore virtuale. Le informazioni sullo stato corrente sono disponibili negli altri parametri per questa funzione di callback.

[in] vSwitchNic

Puntatore a una struttura NDIS_SWITCH_NIC_PARAMETERS che specifica i parametri per una scheda miniport virtuale connessa a una porta del commutatore virtuale.

Valore restituito

Un callout

FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 funzione restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il driver del callout accetta la notifica dal motore di filtro.
Altri codici di stato	Si è verificato un errore.

Commenti

Un driver di callout registra un
Funzione vSwitchInterfaceEventNotifyFn chiamando
funzione FwpsvSwitchEventsSubscribe0 .

Se il parametro eventType è impostato su WPS_VSWITCH_EVENT_INTERFACE_CREATE, viene stabilita completamente una nuova connessione di rete tra una porta del commutatore virtuale e una scheda di rete. Il parametro vSwitchNic identifica una struttura NDIS_SWITCH_NIC_PARAMETERS che contiene informazioni sulla scheda di rete virtuale connessa alla porta del commutatore virtuale.

Se il parametro eventType è FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT, la connessione tra una porta del commutatore virtuale e una scheda di rete viene distrutta. Dopo aver eliminato completamente la connessione, il driver di filtro WFP chiamerà vSwitchInterfaceEventNotifyFn con FWPS_VSWITCH_EVENT_INTERFACE_DELETE impostato nel parametro eventType .

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Windows
Intestazione	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL

Vedi anche

Funzioni callout driver callout

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS