FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
08/07/2023

Il motore di filtro chiama la funzione di callout vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) per notificare al driver 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 Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

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 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 avere il valore iniziale zero, a meno che non sia stato attivato un evento PnP del commutatore virtuale. Le informazioni sullo stato corrente sono disponibili negli altri parametri per 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 del callout accetta la notifica dal motore di filtro.
STATUS_PENDING	L'operazione è in sospeso e verrà completata in un secondo momento. Il driver di callout chiamerà la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.
Altri codici di stato	Si è verificato un errore.

Commenti

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

Se il callback vSwitchPolicyEventNotifyFn è registrato, 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, anche vSwitchPolicyEventNotifyFn verrà richiamato per un'operazione di salvataggio della macchina virtuale.

Le modifiche ai criteri di filtro fornitore configurati tramite l'interfaccia WMI di VMMS vengono passate all'estensione del commutatore virtuale WFP con richieste OID. Questi OID contengono una struttura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS con il membro PropertyType impostato sul tipo 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 di 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 i criteri di porta del commutatore virtuale.

Questi ID includono anche un GUID dell'identificatore di proprietà che identifica in modo univoco il provider DEL 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 IL WFP.

IL 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, IL WFP richiama il valore vSwitchPolicyEventNotifyFn corrispondente 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 dei 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, il WFP restituisce STATUS_PENDING al gestore FilterOidRequest . Il driver di callout chiamerà la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.

Requisiti

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