struttura FWPS_CALLOUT0 (fwpsk.h)
La struttura FWPS_CALLOUT0 definisce i dati necessari per un driver callout per registrare un callout con il motore di filtro.
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.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Disponibile a partire da Windows Vista. |
intestazione | fwpsk.h (include Fwpsk.h) |