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

Artigo
08/07/2023

O mecanismo de filtro chama a função de texto explicativo vSwitchLifetimeNotifyFn (FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0) para notificar o driver de texto explicativo sobre criar e excluir eventos para um comutador virtual.

ObserveFWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 é uma versão específica do FWPS_VSWITCH_LIFETIME_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_LIFETIME_EVENT_CALLBACK0 FwpsVswitchLifetimeEventCallback0;

NTSTATUS FwpsVswitchLifetimeEventCallback0(
  [in, optional] void *notifyContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in, optional] const NDIS_SWITCH_PORT_ARRAY *vSwitchPorts,
  [in, optional] const NDIS_SWITCH_NIC_ARRAY *vSwitchInterfaces
)
{...}

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

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 do 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] vSwitchPorts

Um ponteiro para uma estrutura NDIS_SWITCH_PORT_ARRAY que especifica uma matriz de parâmetros de configuração de porta. Cada elemento na matriz especifica os parâmetros de uma porta em um comutador virtual.

[in, optional] vSwitchInterfaces

Um ponteiro para uma estrutura NDIS_SWITCH_NIC_ARRAY que especifica uma matriz de parâmetros de configuração do adaptador de miniport. Cada elemento na matriz especifica os parâmetros para um adaptador de miniporta virtual ou físico anexado a uma porta em um comutador virtual.

Retornar valor

Um texto explicativo

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

Comentários

Um driver de texto explicativo registra uma função de retorno de chamada vSwitchLifetimeNotifyFn chamando
a função FwpsvSwitchEventsSubscribe0 .

Se o retorno de chamada vSwitchLifetimeNotifyFn for registrado, o driver de filtro WFP notificará o driver de texto explicativo quando uma instância do comutador virtual for criada. Várias instâncias de um comutador virtual podem estar presentes em um host Hyper-V ao mesmo tempo.

O driver de filtro WFP consulta o OID OID_SWITCH_PARAMETERS na função FilterRestart para obter o identificador do comutador virtual associado à instância atual do comutador virtual. O driver de filtro WFP também consulta os OIDs OID_SWITCH_NIC_ARRAY e OID_SWITCH_PORT_ARRAY para obter o conjunto inicial de NICs virtuais configuradas e portas virtuais. O driver de filtro WFP passa as informações de estrutura NDIS_SWITCH_PORT_ARRAY e NDIS_SWITCH_NIC_ARRAY dos OIDs para vSwitchLifetimeNotifyFn com FWPS_VSWITCH_EVENT_VSWITCH_CREATE definido no parâmetro eventType .

No FilterDetach do driver de filtro WFP, o filtro chama com FWPS_VSWITCH_EVENT_VSWITCH_DELETE definido no parâmetro eventTypevSwitchLifetimeNotifyFn .

Um driver de texto explicativo não pode retornar STATUS_PENDING de vSwitchLifetimeNotifyFn.

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