FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
08/07/2023

Il motore di filtro chiama la funzione callout vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) per notificare al driver callout di creare ed eliminare 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 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 di 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 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 comunque avere il valore iniziale pari a zero, a meno che non sia stato attivato un evento PnP 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 della matrice specifica i parametri per una porta in un commutatore virtuale.

[in, optional] vSwitchInterfaces

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

Valore restituito

Callout

FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 funzione restituisce uno dei codici NTSTATUS seguenti.

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

Commenti

Un driver di callout registra una funzione di callout vSwitchLifetimeNotifyFn chiamando
funzione FwpsvSwitchEventsSubscribe0 .

Se il callback vSwitchLifetimeNotifyFn viene registrato, 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 in un host Hyper-V contemporaneamente.

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 query sui OID_SWITCH_NIC_ARRAY e OID_SWITCH_PORT_ARRAY ID per ottenere il set iniziale di schede di interfaccia di rete virtuali configurate e porte virtuali. Il driver di filtro WFP passa le informazioni sulla struttura NDIS_SWITCH_PORT_ARRAY e NDIS_SWITCH_NIC_ARRAY dai dischi rigidi a vSwitchLifetimeNotifyFn con FWPS_VSWITCH_EVENT_VSWITCH_CREATE impostato nel parametro eventType .

Nel filtro DEL PAM FilterDetach, le chiamate di filtro con FWPS_VSWITCH_EVENT_VSWITCH_DELETE impostate nel parametro eventTypevSwitchLifetimeNotifyFn .

Un driver di callout non può restituire STATUS_PENDING da vSwitchLifetimeNotifyFn.

Requisiti

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