FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
02/06/2025

Il motore di filtro chiama la funzione di callout vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) per notificare al driver callout eventi di creazione ed eliminazione di eventi per un commutatore virtuale.

NotaFWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 è una versione specifica di FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 FwpsVswitchLifetimeEventCallback0;

NTSTATUS FwpsVswitchLifetimeEventCallback0(
  [in, optional] void *notifyContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_ARRAY *vSwitchPorts,
  [in, optional] const NDIS_SWITCH_NIC_ARRAY *vSwitchInterfaces
)
{...}

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] 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, optional] vSwitchPorts

Puntatore a una struttura NDIS_SWITCH_PORT_ARRAY che specifica una matrice di parametri di configurazione della porta. Ogni elemento nella matrice specifica i parametri per una porta su un commutatore virtuale.

[in, optional] vSwitchInterfaces

Puntatore a una struttura NDIS_SWITCH_NIC_ARRAY che specifica una matrice di parametri di configurazione dell'adattatore miniport. Ogni elemento nella matrice specifica i parametri per una scheda miniport virtuale o fisica collegata a una porta su un commutatore virtuale.

Valore restituito

Un callout

FWPS_VSWITCH_LIFETIME_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 vSwitchLifetimeNotifyFn funzione di callback chiamando
funzione fwpsvSwitchEventsSubscribe0.

Se la vSwitchLifetimeNotifyFn callback viene registrata, il driver di filtro WFP notifica al driver di callout quando viene creata un'istanza del commutatore virtuale. Più istanze di un commutatore virtuale possono essere presenti contemporaneamente in un host Hyper-V.

Il driver di filtro WFP esegue una query sull'OID OID_SWITCH_PARAMETERS nella funzione FilterRestart per ottenere l'identificatore del commutatore virtuale associato all'istanza corrente del commutatore virtuale. Il driver di filtro WFP esegue anche una query sui OID_SWITCH_NIC_ARRAY e sugli OID OID_SWITCH_PORT_ARRAY per ottenere il set iniziale di schede di interfaccia di rete virtuali e porte virtuali configurate. Il driver di filtro WFP passa le informazioni sulla struttura di NDIS_SWITCH_PORT_ARRAY e NDIS_SWITCH_NIC_ARRAY dagli OID a vSwitchLifetimeNotifyFn con FWPS_VSWITCH_EVENT_VSWITCH_CREATE impostato nel parametro eventType .

Nel FilterDetachdel driver di filtro WFP, le chiamate di filtro con FWPS_VSWITCH_EVENT_VSWITCH_DELETE impostate nel parametro eventTypevSwitchLifetimeNotifyFn.

Un driver callout non può restituire STATUS_PENDING da vSwitchLifetimeNotifyFn.

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