FWPS_VSWITCH_PORT_EVENT_CALLBACK0 funzione di callback (fwpsk.h)

Articolo
08/07/2023

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 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_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 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] 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 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 vSwitchPortEventNotifyFn chiamando la funzione FwpsvSwitchEventsSubscribe0 .

Se il callback vSwitchPortEventNotifyFn è registrato, il driver del 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 del callout chiama la funzione FwpsvSwitchNotifyComplete0 per completare l'operazione in sospeso.

Dopo aver eliminato la porta, il driver di filtro WFP chiama vSwitchPortEventNotifyFn con FWPS_VSWITCH_EVENT_PORT_DELETE impostato nel parametro eventType .

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