FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 fonction de rappel (fwpsk.h)
Le moteur de filtre appelle la fonction de légende vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) pour avertir le pilote de légende des événements associés à l’interface de commutateur virtuel.
Syntaxe
FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 FwpsVswitchInterfaceEventCallback0;
NTSTATUS FwpsVswitchInterfaceEventCallback0(
[in, optional] void *notifyContext,
[in] void *completionContext,
[in] FWPS_VSWITCH_EVENT_TYPE eventType,
[in] const NDIS_SWITCH_PARAMETERS *vSwitch,
[in] const NDIS_SWITCH_NIC_PARAMETERS *vSwitchNic
)
{...}
Paramètres
[in, optional] notifyContext
Pointeur vers un contexte fourni par le pilote de légende. Le pilote a passé ce pointeur au paramètre notifyContext de la fonction FwpsvSwitchEventsSubscribe0. Ce paramètre est facultatif et peut être NULL.
[in] completionContext
Pointeur vers un contexte d’achèvement fourni par le pilote de légende. Ce paramètre est facultatif et peut être NULL.
[in] eventType
Type d’événement de commutateur virtuel spécifié comme l’une des valeurs d’énumération FWPS_VSWITCH_EVENT_TYPE. Pour plus d’informations, consultez Remarques.
[in] vSwitch
Pointeur vers une structure NDIS_SWITCH_PARAMETERS qui contient des informations sur un commutateur virtuel.
[in] vSwitchNic
Pointeur vers une structure NDIS_SWITCH_NIC_PARAMETERS qui spécifie les paramètres d’une carte miniport virtuelle connectée à un port de commutateur virtuel.
Valeur de retour
Légende
FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 fonction retourne l’un des codes NTSTATUS suivants.
Retourner le code | Description |
---|---|
|
Le pilote de légende accepte la notification du moteur de filtre. |
|
Une erreur s’est produite. |
Remarques
Un pilote de légende inscrit un
fonction vSwitchInterfaceEventNotifyFn en appelant
la fonction FwpsvSwitchEventsSubscribe0.
Si le paramètre eventType est défini sur WPS_VSWITCH_EVENT_INTERFACE_CREATE, une nouvelle connexion réseau entre un port de commutateur virtuel et une carte réseau est complètement établie. Le paramètre vSwitchNic identifie une structure NDIS_SWITCH_NIC_PARAMETERS qui contient des informations sur la carte réseau virtuelle connectée au port de commutateur virtuel.
Si le paramètre eventType est FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT, la connexion entre un port de commutateur virtuel et une carte réseau est détruite. Une fois la connexion complètement détruite, le pilote de filtre PAM appelle vSwitchInterfaceEventNotifyFn avec FWPS_VSWITCH_EVENT_INTERFACE_DELETE défini dans le paramètre eventType.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Disponible à partir de Windows 8. |
plateforme cible | Windows |
d’en-tête | fwpsk.h (include Fwpsk.h) |
IRQL | <= DISPATCH_LEVEL |