FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
02/06/2025

Il motore di filtro chiama la funzione callout vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) per notificare al driver del callout gli eventi dei criteri del commutatore virtuale.

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

Sintassi

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 FwpsVswitchPolicyEventCallback0;

NTSTATUS FwpsVswitchPolicyEventCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_PARAMETERS *vSwitchPortProperty,
  [in, optional] const NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS *vSwitchPortPropertyDelete
)
{...}

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

Puntatore a una struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS. Proprietà della porta del commutatore virtuale.

[in, optional] vSwitchPortPropertyDelete

Puntatore a una struttura NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS. Proprietà della porta del commutatore virtuale.

Valore restituito

Un callout

FWPS_VSWITCH_POLICY_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 vSwitchPolicyEventNotifyFn chiamando la funzione FwpsvSwitchEventsSubscribe0.

Se la vSwitchPolicyEventNotifyFn callback è registrata, il callout nell'host di destinazione riceverà una notifica sui criteri configurati per la porta del commutatore virtuale durante la migrazione in tempo reale e prima che la macchina virtuale di migrazione possa essere eseguita nel nuovo host.

Senza migrazione in tempo reale, verrà richiamata anche la vSwitchPolicyEventNotifyFn per un'operazione di salvataggio della macchina virtuale.

Le modifiche apportate ai criteri di filtro fornitore configurati tramite l'interfaccia WMI di VMMS vengono passate all'estensione del commutatore virtuale WFP con richieste OID. Questi ID contengono una struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS con il membro PropertyType impostato sul tipo di NdisSwitchPortPropertyTypeCustom.

Il driver di filtro WFP passa le informazioni nella richiesta OID OID_SWITCH_PORT_PROPERTY_ADD a vSwitchPolicyEventNotifyFn con il tipo di FWPS_VSWITCH_EVENT_POLICY_ADD impostato nel parametro eventType per notificare ai driver callout l'aggiunta di una proprietà dei criteri per una porta del commutatore virtuale.

Il driver di filtro WFP passa le informazioni nella richiesta OID OID_SWITCH_PORT_PROPERTY_UPDATE a vSwitchPolicyEventNotifyFn con il tipo di FWPS_VSWITCH_EVENT_POLICY_UPDATE impostato nel parametro eventType per notificare ai driver di filtro del callout l'aggiornamento di una proprietà per un criterio di porta del commutatore virtuale.

Questi ID includono anche un GUID dell'identificatore di proprietà che identifica in modo univoco il provider WFP a cui appartiene il criterio. Il GUID dell'identificatore di proprietà viene fornito quando un fornitore configura i criteri tramite VMMS e il GUID deve essere lo stesso GUID usato dal fornitore per registrare il provider con WFP.

WFP tenta di trovare la corrispondenza con il GUID dell'identificatore di proprietà con il GUID del provider specificato dalla funzione FwpsvSwitchEventsSubscribe0. Se esiste una corrispondenza, WFP richiama il corrispondente vSwitchPolicyEventNotifyFn e passa la struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS al callout.

Il driver di filtro WFP passa le informazioni nella richiesta OID OID_SWITCH_PORT_PROPERTY_DELETE a vSwitchPolicyEventNotifyFn con il tipo di FWPS_VSWITCH_EVENT_POLICY_DELETE impostato nel parametro eventType per notificare ai driver di filtro del callout l'eliminazione di una proprietà dei criteri per una porta del commutatore virtuale. Le proprietà di eliminazione vengono specificate nella struttura NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS.

Se il callout restituisce STATUS_PENDING da vSwitchPolicyEventNotifyFn, WFP restituisce STATUS_PENDING al gestore FilterOidRequest. Il driver callout chiamerà la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.

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