FWPS_CALLOUT0 struttura (fwpsk.h)

Articolo
08/07/2023

La struttura FWPS_CALLOUT0 definisce i dati necessari per un driver di 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 Versioni specifiche di Windows . Per Windows 8, è disponibile FWPS_CALLOUT2. Per Windows 7 è disponibile FWPS_CALLOUT1 .

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;

Members

calloutKey

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 di 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 la funzione di callout del driver di classificazioneFn0 solo se è presente un contesto associato al flusso di dati. Un driver di callout associa un contesto a un flusso di dati chiamando la funzione FwpsFlowAssociateContext0 .

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

Un driver di callout specifica questo flag per indicare che la funzione di callout del driver di classificazioneFn0 non è influenzata dall'offload delle schede di interfaccia di rete in grado di offload. Se questo flag non è specificato, l'offload dell'elaborazione dati di rete è disabilitato per tutto il traffico elaborato da tutti i filtri che specificano il callout per l'azione del filtro.

classifyFn

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

notifyFn

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

flowDeleteFn

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

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

Commenti

Un driver di 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 di FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW solo per le connessioni in cui il driver è interessato a eseguire controlli di flusso. Questo callout verrà ignorato in tutte le altre connessioni. Le prestazioni saranno migliorate e il driver non dovrà mantenere i dati sullo stato non necessari.