FWPS_VSWITCH_PORT_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
02/06/2025

Il motore di filtro chiama la funzione callout vSwitchPortEventNotifyFn (FWPS_VSWITCH_PORT_EVENT_CALLBACK0) per notificare al driver callout gli eventi associati a una porta del commutatore virtuale (vSwitch).

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

Sintassi

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 FwpsVswitchPortEventCallback0;

NTSTATUS FwpsVswitchPortEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           const NDIS_SWITCH_PORT_PARAMETERS *vSwitchPort
)
{...}

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 vSwitch 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] vSwitchPort

Puntatore a una struttura NDIS_SWITCH_PORT_PARAMETERS che contiene parametri per una porta in un vSwitch.

Valore restituito

Un callout

FWPS_VSWITCH_PORT_EVENT_CALLBACK0 funzione restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il driver callout accetta la notifica dal motore di filtro.
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il driver callout chiamerà la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Un driver callout registra una funzione vSwitchPortEventNotifyFn chiamando la funzione FwpsvSwitchEventsSubscribe0.

Se la vSwitchPortEventNotifyFn callback viene registrata, il driver callout riceve notifiche per la creazione e l'eliminazione delle porte.

Se il parametro eventType è impostato su FWPS_VSWITCH_EVENT_PORT_CREATE, è stata creata una porta vSwitch. In questo caso, il parametro vSwitch identifica una struttura NDIS_SWITCH_PARAMETERS che contiene informazioni sul commutatore virtuale (vSwitch) e il parametro NDIS_SWITCH_PORT_PARAMETERS contiene informazioni sulla porta.

Un callout può restituire STATUS_PENDING da vSwitchPortEventNotifyFn. In questo caso, il driver callout chiama la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.

Dopo l'eliminazione della porta, il driver di filtro WFP chiama vSwitchPortEventNotifyFn con FWPS_VSWITCH_EVENT_PORT_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