FWPS_CALLOUT_CLASSIFY_FN0 función de devolución de llamada (fwpsk.h)

Artículo
02/07/2025

El motor de filtros llama a la función de llamada clasifiqueFn0 función de llamada cada vez que la llamada procese los datos.

NotaclasificarFn0 es la versión específica de classifyFn 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, clasificarFn2 está disponible. Para Windows 7, clasificarFn1 está disponible.

Sintaxis

FWPS_CALLOUT_CLASSIFY_FN0 FwpsCalloutClassifyFn0;

void FwpsCalloutClassifyFn0(
  [in]      const FWPS_INCOMING_VALUES0 *inFixedValues,
  [in]      const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
  [in, out] void *layerData,
  [in]      const FWPS_FILTER0 *filter,
  [in]      UINT64 flowContext,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
)
{...}

Parámetros

[in] inFixedValues

Puntero a una estructura FWPS_INCOMING_VALUES0. Esta estructura contiene los valores de cada uno de los campos de datos en la capa que se está filtrando.

[in] inMetaValues

Puntero a un FWPS_INCOMING_METADATA_VALUES0 estructura. Esta estructura contiene los valores de cada uno de los campos de metadatos en la capa que se está filtrando.

[in, out] layerData

Puntero a una estructura que describe los datos sin procesar en la capa que se está filtrando. Este parámetro puede ser NULL, en función de la capa que se filtra y de las condiciones en las que se llama a la función de llamada clasifiqueFn0. Para la capa de flujo, este parámetro apunta a un estructura FWPS_STREAM_CALLOUT_IO_PACKET0. Para todas las demás capas, este parámetro apunta a una estructura de NET_BUFFER_LIST si no se NULL.

[in] filter

Puntero a una estructura FWPS_FILTER0. Esta estructura describe el filtro que especifica la llamada para la acción del filtro.

[in] flowContext

Variable con tipo UINT64 que contiene el contexto asociado al flujo de datos. Si no hay ningún contexto asociado al flujo de datos, este parámetro es cero. Si la llamada se agrega al motor de filtro en una capa de filtrado que no admite flujos de datos, el clasifiqueFn0 función de llamada debe omitir este parámetro.

[in, out] classifyOut

Puntero a una estructura de FWPS_CLASSIFY_OUT0 que recibe los datos que el clasifiqueFn0 función de llamada vuelve al autor de la llamada.

Valor devuelto

Ninguno

Observaciones

Un controlador de llamada registra las funciones de llamada de una llamada con el motor de filtros llamando a la función fwpsCalloutRegister0.

El motor de filtros llama a la clasifiqueFn0 función de llamada con datos que se van a procesar cada vez que todas las condiciones de prueba sean verdaderas para un filtro en el motor de filtros que especifica la llamada para la acción del filtro.

La función de llamada clasifiqueFn0 debe borrar la marca de FWPS_RIGHT_ACTION_WRITE en los derechos miembro de la estructura FWPS_CLASSIFY_OUT0 en cualquiera de las situaciones siguientes:

Cuando la función de llamada clasifiqueFn0 establece el actionType miembro de la estructura de FWPS_CLASSIFY_OUT0 en FWP_ACTION_BLOCK.
Cuando la función de llamada de clasifiqueFn0 establece el miembro actionType de la estructura FWPS_CLASSIFY_OUT0 en FWP_ACTION_PERMIT y la marca FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT se establece en el miembro Flags de la estructura de FWPS_FILTER0.
Cuando una llamada ha indicado que pretende modificar la lista de búferes net clonados estableciendo el parámetro intendToModify en TRUE en una llamada a la función FwpsReferenceNetBufferList0.

Requisitos

Requisito	Valor
cliente mínimo admitido	Disponible a partir de Windows Vista.
de la plataforma de destino de	Windows
encabezado de	fwpsk.h (incluya Fwpsk.h)
irQL	<= DISPATCH_LEVEL