struttura FWPS_CALLOUT0 (fwpsk.h)

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 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 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;

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 callout del driver di callout classifyFn0 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 callout classifyFn0 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.

classifyFn

Puntatore alla funzione callout del driver di callout classifyFn0 . 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 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_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 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.

Requisiti

   
Client minimo supportato Disponibile a partire da Windows Vista.
Intestazione fwpsk.h (include Fwpsk.h)

Vedi anche

FWPS_CALLOUT1

FWPS_CALLOUT2

FwpsCalloutRegister0

classifyFn0

flowDeleteFn

notifyFn0