Funzione FwpsvSwitchEventsSubscribe0 (fwpsk.h)

Articolo
02/07/2025

La funzione FwpsvSwitchEventsSubscribe0 registra i punti di ingresso del callback per gli eventi del livello del commutatore virtuale, ad esempio la creazione e l'eliminazione di porte virtuali.

NotaFwpsvSwitchEventsSubscribe0 è una versione specifica di FwpsvSwitchEventsSubscribe. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

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

Parametri

providerGuid

GUID del provider.

notifyContext

Puntatore facoltativo a un contesto fornito dal driver callout. Le funzioni di notifica degli eventi passano di nuovo questo parametro al driver.

flags

Riservato. Impostare su zero.

reserved

Riservato. Impostare su zero.

eventDispatchTable

Puntatore a una struttura FWPS_VSWITCH_EVENT_DISPATCH_TABLE che definisce i punti di ingresso del callback per gli eventi del livello del commutatore virtuale.

subscriptionId

Puntatore a una variabile che contiene un identificatore univoco assegnato dal WFP alla sottoscrizione. Il chiamante deve restituire l'identificatore di sottoscrizione a WFP con la funzione FwpsvSwitchEventsUnsubscribe0.

Valore restituito

La funzione FwpsvSwitchEventsSubscribe0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	È stato restituito un handle per la richiesta di classificazione. La variabile a cui punta il parametro classifyHandle contiene l'handle per la richiesta di classificazione.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Un driver callout chiama la funzione FwpsvSwitchEventsSubscribe0 per registrare i punti di ingresso del callback per gli eventi del livello del commutatore virtuale.

I punti di ingresso per le funzioni di notifica di callback sono specificati in e FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 struttura.

Il driver callout deve chiamare successivamente FwpsvSwitchEventsUnsubscribe0 per liberare le risorse di sistema.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	fwpsk.h (include Fwpsk.h)
libreria	Fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Vedere anche

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0

Condividi tramite