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

Artigo
08/07/2023

O mecanismo de filtro chama a função de texto explicativo vSwitchRuntimeStateRestoreNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0) para notificar um driver de texto explicativo sobre eventos de restauração de estado em tempo de execução do comutador virtual.

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

Sintaxe

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_CALLBACK0 FwpsVswitchRuntimeStateRestoreCallback0;

NTSTATUS FwpsVswitchRuntimeStateRestoreCallback0(
  [in, optional] void *notifyContext,
  [in]           void *completionContext,
  [in]           FWPS_VSWITCH_EVENT_TYPE eventType,
  [in]           const NDIS_SWITCH_PARAMETERS *vSwitch,
  [in]           NDIS_SWITCH_PORT_ID portId,
                 void *runtimeState,
  [in]           SIZE_T runtimeStateLength
)
{...}

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

O identificador de porta do comutador de origem.

runtimeState

O local do buffer de resultado de saída do estado de tempo de execução.

[in] runtimeStateLength

O comprimento, em bytes, das informações de estado em tempo de execução no buffer de estado em tempo de execução.

Retornar valor

Um texto explicativo

FWPS_VSWITCH_RUNTIME_STATE_RESTORE_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 vSwitchRuntimeStateRestoreNotifyFn chamando a função FwpsvSwitchEventsSubscribe0 .

Consulte a função vSwitchRuntimeStateSaveNotifyFn (FWPS_VSWITCH_RUNTIME_STATE_SAVE_CALLBACK0) para obter informações sobre como salvar o estado de tempo de execução.

Cada segmento de dados salvos será restaurado com um OID_SWITCH_NIC_RESTORE OID enviado por meio das pilhas de extensão do comutador virtual no sistema de destino ou no sistema local durante uma operação de restauração. O WFP enviará os dados para o texto explicativo correto por meio de vSwitchRuntimeStateRestoreNotifyFn após a correspondência com um GUID do provedor registrado. Nesse caso, o parâmetro eventType de vSwitchRuntimeStateRestoreNotifyFn é definido como FWPS_VSWITCH_EVENT_RUNTIME_STATE_RESTORE.

Um texto explicativo pode retornar STATUS_PENDING de vSwitchRuntimeStateRestoreNotifyFn. Nesse caso, o WFP retornará STATUS_PENDING no manipulador FilterOidRequest e o concluirá posteriormente. O driver de texto explicativo chamará a função FwpsvSwitchNotifyComplete0 para concluir a operação pendente.

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