FWPS_VSWITCH_LIFETIME_EVENT_CALLBACK0 função de retorno de chamada (fwpsk.h)
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.
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.
[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 |
---|---|
|
O driver de texto explicativo aceita a notificação do mecanismo de filtro. |
|
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 |
Confira também
Funções de texto explicativo do driver de texto explicativo