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

  • Artigo

O mecanismo de filtro chama a função de texto explicativo vSwitchInterfaceEventNotifyFn (FWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0) para notificar o driver de texto explicativo sobre eventos associados à interface do comutador virtual.

ObserveFWPS_VSWITCH_INTERFACE_EVENT_CALLBACK0 é uma versão específica do FWPS_VSWITCH_INTERFACE_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_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
)
{...}

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 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] vSwitchNic

Um ponteiro para uma estrutura de NDIS_SWITCH_NIC_PARAMETERS que especifica os parâmetros para um adaptador de miniporto virtual conectado a uma porta de comutador virtual.

Retornar valor

Um texto explicativo

FWPS_VSWITCH_INTERFACE_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.
Outros códigos status
 Ocorreu um erro.

Comentários

Um driver de texto explicativo registra um
Função vSwitchInterfaceEventNotifyFn chamando
a função FwpsvSwitchEventsSubscribe0 .

Se o parâmetro eventType for definido como WPS_VSWITCH_EVENT_INTERFACE_CREATE, uma nova conexão de rede entre uma porta de comutador virtual e um adaptador de rede será completamente estabelecida. O parâmetro vSwitchNic identifica uma estrutura NDIS_SWITCH_NIC_PARAMETERS que contém informações sobre o adaptador de rede virtual conectado à porta do comutador virtual.

Se o parâmetro eventType for FWPS_VSWITCH_EVENT_INTERFACE_DISCONNECT, a conexão entre uma porta de comutador virtual e um adaptador de rede será interrompida. Depois que a conexão tiver sido completamente interrompida, o driver de filtro WFP chamará vSwitchInterfaceEventNotifyFn com FWPS_VSWITCH_EVENT_INTERFACE_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

Confira também

Funções de texto explicativo do driver de texto explicativo

FWPS_VSWITCH_EVENT_TYPE

FwpsvSwitchEventsSubscribe0

NDIS_SWITCH_NIC_PARAMETERS

NDIS_SWITCH_PARAMETERS