FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 função de retorno de chamada (fwpsk.h)

Artigo
02/06/2025

O mecanismo de filtro chama a função de texto explicativo vSwitchPolicyEventNotifyFn (FWPS_VSWITCH_POLICY_EVENT_CALLBACK0) para notificar o driver de texto explicativo sobre eventos de política de comutador virtual.

ObservaçãoFWPS_VSWITCH_POLICY_EVENT_CALLBACK0 é uma versão específica do FWPS_VSWITCH_POLICY_EVENT_CALLBACK. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

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

Um ponteiro para um contexto fornecido pelo driver de texto explicativo. O driver passou esse ponteiro para o parâmetro notifyContext da função FwpsvSwitchEventsSubscribe0. Esse parâmetro é opcional e pode ser NULL.

[in] completionContext

Um ponteiro para um contexto de conclusão fornecido pelo driver de texto explicativo. Esse parâmetro é opcional e pode ser NULL.

[in] eventType

O tipo de evento de comutador virtual especificado como um dos valores de enumeração FWPS_VSWITCH_EVENT_TYPE. Para obter mais informações, consulte Comentários.

[in] vSwitch

Um ponteiro para uma estrutura NDIS_SWITCH_PARAMETERS que contém informações sobre um comutador virtual.

Observação As informações na estrutura NDIS_SWITCH_PARAMETERS refletem o estado inicial do comutador virtual, não necessariamente seu estado atual. Em particular, os membros NumSwitchPorts e IsActive ainda podem ter o valor inicial de zero, a menos que um evento PnP de comutador virtual tenha sido disparado. As informações de estado atuais podem ser encontradas nos outros parâmetros para essa função de retorno de chamada.

[in, optional] vSwitchPortProperty

Um ponteiro para uma estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS. A propriedade de porta do comutador virtual.

[in, optional] vSwitchPortPropertyDelete

Um ponteiro para uma estrutura NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS. A propriedade de porta do comutador virtual.

Valor de retorno

Um texto explicativo

FWPS_VSWITCH_POLICY_EVENT_CALLBACK0 função retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	O driver de texto explicativo aceita a notificação do mecanismo de filtro.
STATUS_PENDING	A operação está pendente e será concluída posteriormente. O driver de texto explicativo chamará a função FwpsvSwitchNotifyComplete0 para concluir a operação pendente.
Outros códigos de status	Ocorreu um erro.

Observações

Um driver de texto explicativo registra uma função vSwitchPolicyEventNotifyFn chamando a função FwpsvSwitchEventsSubscribe0.

Se o vSwitchPolicyEventNotifyFn retorno de chamada estiver registrado, o texto explicativo no host de destino será notificado sobre a política configurada para a porta de comutador virtual durante a migração ao vivo e antes que a VM de migração possa ser executada no novo host.

Sem a migração ao vivo, vSwitchPolicyEventNotifyFn também serão invocados para uma operação de salvamento de VM.

As alterações nas políticas de filtragem do fornecedor configuradas por meio da interface WMI do VMMS são passadas para a extensão de comutador virtual WFP com solicitações OID. Esses OIDs carregam uma estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS com o membro PropertyType definido como o tipo de NdisSwitchPortPropertyTypeCustom.

O driver de filtro WFP passa as informações na solicitação OID OID_SWITCH_PORT_PROPERTY_ADD para vSwitchPolicyEventNotifyFn com o tipo FWPS_VSWITCH_EVENT_POLICY_ADD definido no parâmetro eventType para notificar os drivers de texto explicativo sobre a adição de uma propriedade de política para uma porta de comutador virtual.

O driver de filtro WFP passa as informações na solicitação OID OID_SWITCH_PORT_PROPERTY_UPDATE para vSwitchPolicyEventNotifyFn com o tipo FWPS_VSWITCH_EVENT_POLICY_UPDATE definido no parâmetro eventType para notificar os drivers de filtro de texto explicativo sobre a atualização de uma propriedade para uma política de porta de comutador virtual.

Esses OIDs também incluem um GUID do identificador de propriedade que identifica exclusivamente a qual provedor WFP a política pertence. O GUID do identificador de propriedade é fornecido quando um fornecedor configura sua política por meio do VMMS e o GUID deve ser o mesmo GUID que o fornecedor usa para registrar seu provedor no WFP.

O WFP tenta corresponder o GUID do identificador de propriedade com o GUID do provedor especificado da função FwpsvSwitchEventsSubscribe0. Se houver uma correspondência, o WFP invocará o vSwitchPolicyEventNotifyFn correspondente e passará a estrutura NDIS_SWITCH_PORT_PROPERTY_PARAMETERS para o texto explicativo.

O driver de filtro WFP passa as informações na solicitação OID OID_SWITCH_PORT_PROPERTY_DELETE para vSwitchPolicyEventNotifyFn com o tipo FWPS_VSWITCH_EVENT_POLICY_DELETE definido no parâmetro eventType para notificar os drivers de filtro de texto explicativo sobre a exclusão de uma propriedade de política para uma porta de comutador virtual. As propriedades de exclusão são especificadas na estrutura NDIS_SWITCH_PORT_PROPERTY_DELETE_PARAMETERS.

Se o texto explicativo retornar STATUS_PENDING de vSwitchPolicyEventNotifyFn, o WFP retornará STATUS_PENDING ao manipulador de FilterOidRequest. O driver de texto explicativo chamará a função FwpsvSwitchNotifyComplete0 para concluir a operação pendente.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Windows
cabeçalho	fwpsk.h (inclua Fwpsk.h)
IRQL	<= DISPATCH_LEVEL