FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
02/06/2025

Il motore di filtro chiama la funzione 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 nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

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 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 pari a zero, a meno che non sia stato attivato un evento PnP del commutatore virtuale. Le informazioni sullo stato corrente sono disponibili negli altri parametri di 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 callout accetta la notifica dal motore di filtro.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Un driver 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 detronata. Dopo aver eliminato completamente la connessione, il driver di filtro WFP chiamerà vSwitchInterfaceEventNotifyFn con FWPS_VSWITCH_EVENT_INTERFACE_DELETE impostato nel parametro eventType .

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Finestre
intestazione	fwpsk.h (include Fwpsk.h)
IRQL	<= DISPATCH_LEVEL

Vedere anche

funzioni callout del driver callout

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS

Condividi tramite