FWPS_CALLOUT_NOTIFY_FN1 funzione di callback (fwpsk.h)
Il motore di filtro chiama una funzione callout notifyFn1 del callout per notificare al driver callout gli eventi associati al callout.
Sintassi
FWPS_CALLOUT_NOTIFY_FN1 FwpsCalloutNotifyFn1;
NTSTATUS FwpsCalloutNotifyFn1(
[in] FWPS_CALLOUT_NOTIFY_TYPE notifyType,
[in] const GUID *filterKey,
[in] FWPS_FILTER1 *filter
)
{...}
Parametri
[in] notifyType
Valore che indica il tipo di notifica che il motore di filtro invia al callout. I valori validi per questo parametro sono:
FWPS_CALLOUT_NOTIFY_ADD_FILTER
Viene aggiunto un filtro al motore di filtro che specifica il callout per l'azione del filtro.
FWPS_CALLOUT_NOTIFY_DELETE_FILTER
Un filtro viene eliminato dal motore di filtro che specifica il callout per l'azione del filtro.
FWPS_CALLOUT_NOTIFY_TYPE_MAX
Valore massimo a scopo di test.
[in] filterKey
Puntatore all'identificatore di gestione per il filtro, come specificato dall'applicazione o dal driver che aggiunge o elimina il filtro. Deve essere NULL se il parametro notifyType è impostato su FWPS_CALLOUT_NOTIFY_DELETE_FILTER. Per altre informazioni, vedere la sezione Osservazioni.
[in] filter
Puntatore a una struttura FWPS_FILTER1 . Questa struttura descrive il filtro che viene aggiunto o eliminato dal motore di filtro.
La funzione notifyFn1 di un driver di callout può impostare il membro Context di questa struttura in modo che punti a una struttura di contesto fornita dal driver di callout quando il filtro viene aggiunto al motore di filtro. Questa struttura di contesto è opaca per il motore di filtro e può essere usata dalla funzione di callout classifyFn1 del driver per mantenere i dati o le informazioni sullo stato specifici del driver tra le chiamate dal motore di filtro al driver del callout
funzione callout classifyFn1 .
La funzione notifyFn1 di un driver di callout può pulire qualsiasi contesto associato al filtro quando il filtro viene eliminato dal motore di filtro.
Valore restituito
La funzione notifyFn1 di un callout restituisce uno dei codici NTSTATUS seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Il driver del callout accetta la notifica dal motore di filtro. |
|
Si è verificato un errore. Se il parametro notifyType è FWPS_CALLOUT_NOTIFY_ADD_FILTER, il filtro non verrà aggiunto al motore di filtro. Se il parametro notifyType è FWPS_CALLOUT_NOTIFY_DELETE_FILTER, il filtro verrà comunque eliminato dal motore di filtro. |
Commenti
Un driver callout registra le funzioni di callout di un callout con il motore di filtro chiamando la funzione FwpsCalloutRegister1 .
Il motore di filtro chiama una funzione notifyFn1 del driver del callout per notificare al driver di callout gli eventi associati al callout. Se la funzione notifyFn1 del driver del callout non riconosce il tipo di notifica passata nel parametro notifyType , deve ignorare la notifica e restituire STATUS_SUCCESS.
Se un driver di callout registra un callout con il motore di filtro dopo i filtri che specificano il callout per l'azione del filtro è già stato aggiunto al motore di filtro, il motore di filtro non chiama la funzione notifyFn1 del driver del callout per notificare al callout uno qualsiasi dei filtri esistenti. Il motore di filtro chiama la funzione notifyFn1 del driver del callout per notificare al callout quando nuovi filtri che specificano il callout per l'azione del filtro vengono aggiunti al motore di filtro. In questo caso, la funzione notifyFn1 di un callout potrebbe non essere chiamata per ogni filtro nel motore di filtro che specifica il callout per l'azione del filtro. Se un driver callout registra un callout dopo l'avvio del motore di filtro e il callout deve conoscere ogni filtro nel motore di filtro che specifica il callout per l'azione del filtro, il driver del callout deve chiamare le funzioni di gestione appropriate per enumerare tutti i filtri nel motore di filtro e ordinare l'elenco di filtri risultante per trovare quelli che specificano il callout per l'azione del filtro. Per altre informazioni sulla chiamata di queste funzioni, vedere Chiamata di altre funzioni della piattaforma di filtro di Windows .
Quando un filtro che specifica un callout per l'azione del filtro viene eliminato dal motore di filtro, il motore di filtro chiama la funzione notifyFn1 del driver del callout e passa FWP_CALLOUT_NOTIFY_DELETE_FILTER nel parametro notifyType e NULL nel parametro filterKey . Per altre informazioni, vedere Elaborazione di callout notifica.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 7. |
| Piattaforma di destinazione | Windows |
| Intestazione | fwpsk.h (include Fwpsk.h) |
| IRQL | <= DISPATCH_LEVEL |