estructura FWPS_CALLOUT1 (fwpsk.h)
La estructura FWPS_CALLOUT1 define los datos necesarios para que un controlador de llamada registre una llamada con el motor de filtro.
Sintaxis
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;
Miembros
calloutKey
Un GUID definido por el controlador de llamada que identifica de forma única la llamada.
flags
Marcas que especifican parámetros específicos de la llamada. Las marcas posibles son:
| Valor | Significado |
|---|---|
|
Un controlador de llamada puede especificar esta marca al registrar una llamada que se agregará en una capa que admita flujos de datos. Si se especifica esta marca, el motor de filtro llama a la función de llamada classifyFn1 del controlador de llamada solo si hay un contexto asociado al flujo de datos. Un controlador de llamada asocia un contexto a un flujo de datos mediante una llamada a la función FwpsFlowAssociateContext0 . |
|
Un controlador de llamada especifica esta marca para indicar que la función de llamada classifyFn1 del controlador de llamada no se ve afectada al descargar el procesamiento de datos de red para descargar tarjetas de interfaz de red (NIC) compatibles con la descarga. Si no se especifica esta marca, la descarga de procesamiento de datos de red está deshabilitada para todo el tráfico procesado por los filtros que especifican la llamada para la acción del filtro. |
|
Un controlador de llamada especifica esta marca para indicar que puede recibir notificaciones sobre objetos y filtros que se agregan dentro de una transacción. El motor de filtro envía la notificación después de confirmar la transacción. |
|
Un controlador de llamada especifica esta marca para indicar que puede realizar la inspección dinámica de flujos de datos en el nivel de flujo. Consulte inspección de Stream. |
|
Un controlador de llamada especifica esta marca para registrarse para llamarse cuando se vuelve a clasificar una operación de socket existente. |
classifyFn
Puntero a la función de llamada classifyFn1 del controlador de llamada. El motor de filtros llama a esta función siempre que la llamada procese los datos de red.
notifyFn
Puntero a la función notifyFn1 del controlador de llamada. El motor de filtros llama a esta función para notificar al controlador de llamada los eventos asociados a la llamada.
flowDeleteFn
Puntero a la función de llamada flowDeleteFn del controlador de llamada. El motor de filtro llama a esta función cada vez que finaliza un flujo de datos que está procesando la llamada.
Si un controlador de llamada no asocia un contexto con los flujos de datos que procesa la llamada, este miembro debe establecerse en NULL.
Comentarios
Un controlador de llamada pasa un puntero a una estructura de FWPS_CALLOUT1 inicializada a la función FwpsCalloutRegister1 cuando registra una llamada con el motor de filtro.
Una llamada puede establecer la marca FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW solo para las conexiones en las que el controlador está interesado en realizar inspecciones de flujo. Esta llamada se omitirá en todas las demás conexiones. El rendimiento se mejorará y el controlador no tendrá que mantener datos de estado innecesarios.
Esta estructura es esencialmente idéntica a la versión anterior, FWPS_CALLOUT0. Las únicas diferencias son que los miembros de esta versión almacenan las versiones actualizadas de los punteros de función de llamada y hay marcas adicionales disponibles para que se establezcan los controladores de llamada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 7. |
| Encabezado | fwpsk.h (incluya Fwpsk.h) |