Funzione fwpsvSwitchEventsSubscribe0 (fwpsk.h)

Articolo
02/26/2024

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

NotaFwpsvSwitchEventsSubscribe0 è una versione specifica di FwpsvSwitchEventsSubscribe. Per altre informazioni , vedere Nomi Version-Independent WFP e 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 driver di callout fornito. Le funzioni di notifica degli eventi passano di nuovo questo parametro al driver.

flags

Riservato. Imposta su zero.

reserved

Riservato. Imposta 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 di commutatore virtuale.

subscriptionId

Puntatore a una variabile contenente un identificatore univoco assegnato dal WFP alla sottoscrizione. Il chiamante deve restituire l'identificatore di sottoscrizione al 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 alla richiesta di classificazione. Variabile che il parametro classifyHandle punta a contiene l'handle per la richiesta di classificazione.
Altri codici di stato	Si è verificato un errore.

Commenti

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

I punti di ingresso per le funzioni di notifica di callback vengono specificati nella struttura e FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 .

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

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8.
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (includere Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Vedi anche

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0

Condividi tramite