FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 función de devolución de llamada (fwpsk.h)

Artículo
08/07/2023

El motor de filtro llama a la función de llamada vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) para notificar al controlador de llamada los eventos de directiva de conmutador virtual.

NotaFWPS_VSWITCH_POLICY_EVENT_CALLBACK0 es una versión específica de FWPS_VSWITCH_POLICY_EVENT_CALLBACK. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

Sintaxis

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
)
{...}

Parámetros

[in, optional] notifyContext

Puntero a un contexto proporcionado por el controlador de llamada. El controlador pasó este puntero al parámetro notifyContext de la función FwpsvSwitchEventsSubscribe0 . Este parámetro es opcional y puede ser NULL.

[in] completionContext

Puntero a un contexto de finalización proporcionado por el controlador de llamada. Este parámetro es opcional y puede ser NULL.

[in] eventType

Tipo de evento de conmutador virtual especificado como uno de los valores de enumeración de FWPS_VSWITCH_EVENT_TYPE . Para obtener más información, vea la sección Comentarios.

[in] vSwitch

Puntero a una estructura NDIS_SWITCH_PARAMETERS que contiene información sobre un conmutador virtual.

Nota La información de la estructura NDIS_SWITCH_PARAMETERS refleja el estado inicial del conmutador virtual, no necesariamente su estado actual. En concreto, es posible que los miembros NumSwitchPorts e IsActive sigan teniendo su valor inicial de cero, a menos que se desencadene un evento PnP de conmutador virtual. La información de estado actual se puede encontrar en los demás parámetros de esta función de devolución de llamada.

[in, optional] vSwitchPortProperty

Puntero a una estructura de NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Propiedad del puerto del conmutador virtual.

[in, optional] vSwitchPortPropertyDelete

Puntero a una estructura de NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS . Propiedad del puerto del conmutador virtual.

Valor devuelto

Una llamada

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 función devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto	Descripción
STATUS_SUCCESS	El controlador de llamada acepta la notificación del motor de filtro.
STATUS_PENDING	La operación está pendiente y se completará más adelante. El controlador de llamada llamará a la función FwpsvSwitchNotifyComplete0 para completar la operación pendiente.
Otros códigos de estado	Se produjo un error.

Comentarios

Un controlador de llamada registra una función vSwitchPolicyEventNotifyFn mediante una llamada a la función FwpsvSwitchEventsSubscribe0 .

Si se registra la devolución de llamada vSwitchPolicyEventNotifyFn , se notificará a la llamada en el host de destino sobre la directiva configurada para el puerto del conmutador virtual durante la migración en vivo y antes de que la máquina virtual de migración se pueda ejecutar en el nuevo host.

Sin la migración en vivo, también se invocará vSwitchPolicyEventNotifyFn para una operación de guardado de máquina virtual.

Los cambios en las directivas de filtrado de proveedores configuradas a través de la interfaz WMI de VMMS se pasan a la extensión de conmutador virtual DE PMA con solicitudes OID. Estos OID llevan una estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS con el miembro PropertyType establecido en el tipo NdisSwitchPortPropertyTypeCustom .

El controlador de filtro DE PMA pasa la información de la solicitud de OID de OID_SWITCH_PORT_PROPERTY_ADD a vSwitchPolicyEventNotifyFn con el tipo FWPS_VSWITCH_EVENT_POLICY_ADD establecido en el parámetro eventType para notificar a los controladores de llamada la adición de una propiedad de directiva para un puerto de conmutador virtual.

El controlador de filtro DE PMA pasa la información de la solicitud de OID de OID_SWITCH_PORT_PROPERTY_UPDATE a vSwitchPolicyEventNotifyFn con el tipo FWPS_VSWITCH_EVENT_POLICY_UPDATE establecido en el parámetro eventType para notificar a los controladores de filtro de llamada sobre la actualización de una propiedad para una directiva de puerto de conmutador virtual.

Estos OID también incluyen un GUID de identificador de propiedad que identifica de forma única a qué proveedor de PMA pertenece la directiva. El GUID del identificador de propiedad se proporciona cuando un proveedor configura su directiva a través de VMMS, y el GUID debe ser el mismo GUID que el proveedor usa para registrar su proveedor con EL PMA.

EL PMA intenta hacer coincidir el GUID del identificador de propiedad con el GUID del proveedor especificado desde la función FwpsvSwitchEventsSubscribe0 . Si hay una coincidencia, EL PMA invoca el vSwitchPolicyEventNotifyFn correspondiente y pasa la estructura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS a la llamada.

El controlador de filtro DE PMA pasa la información de la solicitud de OID de OID_SWITCH_PORT_PROPERTY_DELETE a vSwitchPolicyEventNotifyFn con el tipo FWPS_VSWITCH_EVENT_POLICY_DELETE establecido en el parámetro eventType para notificar a los controladores de filtro de llamada sobre la eliminación de una propiedad de directiva para un puerto de conmutador virtual. Las propiedades delete se especifican en la estructura NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS .

Si la llamada devuelve STATUS_PENDING de vSwitchPolicyEventNotifyFn, EL PMA devuelve STATUS_PENDING al controlador FilterOidRequest . El controlador de llamada llamará a la función FwpsvSwitchNotifyComplete0 para completar la operación pendiente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8.
Plataforma de destino	Windows
Encabezado	fwpsk.h (incluya Fwpsk.h)
IRQL	<= DISPATCH_LEVEL