estructura FWPS_CALLOUT0 (fwpsk.h)

Artículo
02/07/2025

La estructura FWPS_CALLOUT0 define los datos necesarios para que un controlador de llamada registre una llamada con el motor de filtro.

NotaFWPS_CALLOUT0 es la versión específica de FWPS_CALLOUT usada en Windows Vista y versiones posteriores. Consulta nombres Version-Independent DEL PMA y destinatarios de versiones específicas de Windows para obtener más información. Para Windows 8, FWPS_CALLOUT2 está disponible. Para Windows 7, FWPS_CALLOUT1 está disponible.

Sintaxis

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;

Miembros

calloutKey

Una llamada definida por el controlador GUID que identifica de forma única la llamada.

flags

Marcas que especifican parámetros específicos de la llamada. Las marcas posibles son:

FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW

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 del controlador de llamada clasifiqueFn0 función de llamada solo si hay un contexto asociado al flujo de datos. Un controlador de llamada asocia un contexto a un flujo de datos llamando a la función FwpsFlowAssociateContext0.

FWP_CALLOUT_FLAG_ALLOW_OFFLOAD

Un controlador de llamada especifica esta marca para indicar que la función de llamada clasifiqueFn0 función 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 del 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.

classifyFn

Puntero a la función de llamada clasifiqueFn0 función de llamada. El motor de filtro llama a esta función siempre que la llamada procese los datos de red.

notifyFn

Puntero a la función notifyFn0 del controlador de llamada. El motor de filtro 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 a los flujos de datos que procesa la llamada, este miembro debe establecerse en NULL.

Observaciones

Un controlador de llamada pasa un puntero a una estructura de FWPS_CALLOUT0 inicializada al FwpsCalloutRegister0 función 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.