struttura FWPS_CALLOUT1 (fwpsk.h)

Articolo
08/07/2023

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

NotaFWPS_CALLOUT1 è la versione specifica di FWPS_CALLOUT usata in Windows 7 e versioni successive. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. Per Windows 8 è disponibile FWPS_CALLOUT2. Per Windows Vista, FWPS_CALLOUT0 è disponibile.

Sintassi

typedef struct FWPS_CALLOUT1_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN1           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN1             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT1;

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:

Valore	Significato
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW 0x00000001	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 callout del driver di callout classifyFn1 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 0x00000002	Un driver di callout specifica questo flag per indicare che la funzione callout del driver di callout classifyFn1 non è interessata 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 qualsiasi filtro che specifica il callout per l'azione del filtro.
FWP_CALLOUT_FLAG_ENABLE_COMMIT_ADD_NOTIFY 0x00000004	Un driver di callout specifica questo flag per indicare che può ricevere notifiche su oggetti e filtri aggiunti all'interno di una transazione. Il motore di filtro invia la notifica dopo il commit della transazione.
FWP_CALLOUT_FLAG_ALLOW_MID_STREAM_INSPECTION 0x00000008	Un driver di callout specifica questo flag per indicare che può eseguire l'ispezione dinamica dei flussi di dati a livello di flusso. Vedere Stream Ispezione.
FWP_CALLOUT_FLAG_ALLOW_RECLASSIFY 0x00000010	Un driver di callout specifica questo flag da registrare da chiamare quando viene riclassificata un'operazione socket esistente.

classifyFn

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

notifyFn

Puntatore alla funzione notifyFn1 del driver del callout. Il motore di filtro chiama questa funzione per notificare al driver callout gli 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 elaborato dal callout.

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

Commenti

Un driver di callout passa un puntatore a una struttura di FWPS_CALLOUT1 inizializzata alla funzione FwpsCalloutRegister1 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 su cui il driver è interessato a eseguire ispezioni del flusso. Questo callout verrà ignorato in tutte le altre connessioni. Le prestazioni verranno migliorate e il driver non dovrà gestire i dati di stato non necessari.

Questa struttura è essenzialmente identica alla versione precedente, FWPS_CALLOUT0. Le uniche differenze sono che i membri di questa versione archiviano le versioni aggiornate dei puntatori a funzione del callout e sono disponibili flag aggiuntivi per i driver di callout da impostare.