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

Artigo
08/07/2023

O mecanismo de filtro chama a função de texto explicativo vSwitchPortEventNotifyFn (FWPS_VSWITCH_PORT_EVENT_CALLBACK0) para notificar o driver de texto explicativo sobre eventos associados a uma porta de comutador virtual (vSwitch).

ObserveFWPS_VSWITCH_PORT_EVENT_CALLBACK0 é uma versão específica do FWPS_VSWITCH_PORT_EVENT_CALLBACK. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

Sintaxe

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

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 vSwitch do 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 de NDIS_SWITCH_PARAMETERS que contém informações sobre um comutador virtual.

Nota 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 seu valor inicial igual a 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] vSwitchPort

Um ponteiro para uma estrutura NDIS_SWITCH_PORT_PARAMETERS que contém parâmetros para uma porta em um vSwitch.

Retornar valor

Um texto explicativo

FWPS_VSWITCH_PORT_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 status	Ocorreu um erro.

Comentários

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

Se o retorno de chamada vSwitchPortEventNotifyFn for registrado, o driver de texto explicativo receberá notificações para criação e exclusão de porta.

Se o parâmetro eventType for definido como FWPS_VSWITCH_EVENT_PORT_CREATE, uma porta vSwitch será criada. Nesse caso, o parâmetro vSwitch identifica uma estrutura NDIS_SWITCH_PARAMETERS que contém informações sobre o comutador virtual (vSwitch) e o parâmetro NDIS_SWITCH_PORT_PARAMETERS contém informações sobre a porta.

Um texto explicativo pode retornar STATUS_PENDING de vSwitchPortEventNotifyFn. Nesse caso, o driver de texto explicativo chama a função FwpsvSwitchNotifyComplete0 para concluir a operação pendente.

Depois que a porta é excluída, o driver de filtro WFP chama vSwitchPortEventNotifyFn com FWPS_VSWITCH_EVENT_PORT_DELETE definido no parâmetro eventType .

Requisitos

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