Função FwpsvSwitchEventsSubscribe0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsvSwitchEventsSubscribe0 registra pontos de entrada de retorno de chamada para eventos de camada de comutador virtual, como criação e exclusão de porta virtual.

ObservaçãoFwpsvSwitchEventsSubscribe0 é uma versão específica do FwpsvSwitchEventsSubscribe. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

Parâmetros

providerGuid

O GUID do provedor.

notifyContext

Um ponteiro opcional para um contexto fornecido pelo driver de texto explicativo. As funções de notificação de evento passam esse parâmetro de volta para o driver.

flags

Reservado. Definido como zero.

reserved

Reservado. Definido como zero.

eventDispatchTable

Um ponteiro para uma estrutura de FWPS_VSWITCH_EVENT_DISPATCH_TABLE que define os pontos de entrada de retorno de chamada para eventos de camada de comutador virtual.

subscriptionId

Um ponteiro para uma variável que contém um identificador exclusivo que o WFP atribui à assinatura. O chamador deve retornar o identificador de assinatura ao WFP com a função FwpsvSwitchEventsUnsubscribe0.

Valor de retorno

A função FwpsvSwitchEventsSubscribe0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	Um identificador para a solicitação de classificação foi retornado com êxito. A variável que o classifyHandle aponta para conter o identificador da solicitação de classificação.
Outros códigos de status	Ocorreu um erro.

Observações

Um driver de texto explicativo chama a função FwpsvSwitchEventsSubscribe0 para registrar pontos de entrada de retorno de chamada para eventos de camada de comutador virtual.

Os pontos de entrada para as funções de notificação de retorno de chamada são especificados dentro e FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 estrutura.

O driver de texto explicativo deve chamar posteriormente FwpsvSwitchEventsUnsubscribe0 para liberar os recursos do sistema.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 8.
da Plataforma de Destino	Universal
cabeçalho	fwpsk.h (inclua Fwpsk.h)
biblioteca	Fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Consulte também

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0

Compartilhar via