struttura FWPS_CALLOUT0 (fwpsk.h)

Articolo
02/07/2025

La struttura FWPS_CALLOUT0 definisce i dati necessari per un driver callout per registrare un callout con il motore di filtro.

NotaFWPS_CALLOUT0 è la versione specifica di FWPS_CALLOUT usata in Windows Vista e versioni successive. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows. Per Windows 8, FWPS_CALLOUT2 è disponibile. Per Windows 7, FWPS_CALLOUT1 è disponibile.

Sintassi

typedef struct FWPS_CALLOUT0_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN0           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN0             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT0;

Membri

calloutKey

Un GUID definito dal driver di callout che identifica in modo univoco il callout.

flags

Flag che specificano parametri specifici del callout. I flag possibili sono:

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

Un driver callout può specificare questo flag durante la registrazione di un callout che verrà aggiunto a un livello che supporta i flussi di dati. Se questo flag viene specificato, il motore di filtro chiama il driver del callout classifyFn0 funzione callout solo se al flusso di dati è associato un contesto. Un driver callout associa un contesto a un flusso di dati chiamando la funzione FwpsFlowAssociateContext0.

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

Un driver callout specifica questo flag per indicare che il driver del callout classifyFn0 funzione di callout non è interessato dall'offload dell'elaborazione dei dati di rete alle schede di interfaccia di rete che supportano l'offload. Se questo flag non viene specificato, l'offload dell'elaborazione dati di rete viene disabilitato per tutto il traffico elaborato da tutti i filtri che specificano il callout per l'azione del filtro.

classifyFn

Puntatore al driver del callout classificareFn0 funzione callout. Il motore di filtro chiama questa funzione ogni volta che sono presenti dati di rete da elaborare dal callout.

notifyFn

Puntatore alla funzione del driver del callout notifyFn0. Il motore di filtro chiama questa funzione per notificare al driver callout gli eventi associati al callout.

flowDeleteFn

Puntatore alla funzione callout del driver flowDeleteFn. Il motore di filtro chiama questa funzione ogni volta che viene terminato un flusso di dati elaborato dal callout.

Se un driver callout non associa un contesto ai flussi di dati elaborati dai callout, questo membro deve essere impostato su NULL.

Osservazioni

Un driver callout passa un puntatore a una struttura di FWPS_CALLOUT0 inizializzata alla funzione FwpsCalloutRegister0 quando registra un callout con il motore di filtro.

Un callout può impostare il flag FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW solo per le connessioni su cui il driver è interessato a eseguire ispezioni del flusso. Questo callout verrà ignorato in tutte le altre connessioni. Le prestazioni saranno migliorate e il driver non dovrà gestire i dati sullo stato non necessari.