Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La estructura NDIS_FILTER_INTERFACE define los atributos de un filtro NDIS.
Sintaxis
typedef struct _NDIS_FILTER_INTERFACE {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
ULONG FilterType;
ULONG FilterRunType;
NET_IFINDEX IfIndex;
NET_LUID NetLuid;
NDIS_STRING FilterClass;
NDIS_STRING FilterInstanceName;
} NDIS_FILTER_INTERFACE, *PNDIS_FILTER_INTERFACE;
Miembros
Header
Estructura NDIS_OBJECT_HEADER para la estructura de la interfaz de filtro.
NDIS establece el miembro Type de la estructura que Encabezado especifica para NDIS_OBJECT_TYPE_DEFAULT.
Si el identificador pasado a NdisEnumerateFilterModules pertenece a un objeto NDIS 6.30 o posterior, NDIS establece Revision en NDIS_FILTER_INTERFACE_REVISION_2 y Size en NDIS_SIZEOF_FILTER_INTERFACE_REVISION_2.
Si el identificador pasado a NdisEnumerateFilterModules pertenece a un objeto NDIS 6.20 o anterior, NDIS establece Revision en NDIS_FILTER_INTERFACE_REVISION_1 y Size en NDIS_SIZEOF_FILTER_INTERFACE_REVISION_1.
Flags
Campo de bits que define el tipo de controlador NDIS que implementa el filtro. Este miembro debe establecerse en uno de los siguientes tipos de controladores:
NDIS_FILTER_INTERFACE_IM_FILTER
El filtro se implementa en un controlador intermedio de filtro NDIS 5.1 o anterior.
NDIS_FILTER_INTERFACE_LW_FILTER
El filtro se implementa en un controlador de filtro NDIS 6.0 o posterior.
NDIS_FILTER_INTERFACE_SEND_BYPASS
El filtro no está asociado actualmente a la ruta de acceso de envío. Esta marca solo se establece si header.Revision es mayor o igual que NDIS_FILTER_INTERFACE_REVISION_2.
NDIS_FILTER_INTERFACE_RECEIVE_BYPASS
El filtro no está asociado actualmente a la ruta de acceso de recepción. Esta marca solo se establece si header.Revision es mayor o igual que NDIS_FILTER_INTERFACE_REVISION_2.
FilterType
Tipo de comportamiento para el filtro. Este tipo debe ser uno de los siguientes valores:
NdisFilterTypeMonitoring = 1
Filtro de supervisión.
NdisFilterTypeModifying = 2
Filtro de modificación.
FilterRunType
Tipo de prioridad de datos adjuntos en tiempo de ejecución para el filtro. Este tipo debe ser uno de los siguientes valores:
NdisFilterRunTypeMandatory = 1
Filtro obligatorio. Si el filtro no se asocia a la pila de controladores, NDIS anulará el resto de la pila.
NdisFilterRunTypeOptional = 2
Un filtro opcional. Si el filtro no se asocia a la pila de controladores, NDIS no anulará el resto de la pila.
IfIndex
Índice de la interfaz NDIS del módulo de filtro.
NetLuid
Valor NET_LUID asignado al módulo de filtro. El NET_LUID es equivalente al nombre de la interfaz (ifName en RFC 2863).
FilterClass
Cadena UNICODE que especifica la clase de filtro. Esta cadena es la misma que la entrada de archivo INF de FilterClass.
FilterInstanceName
Nombre de la instancia de filtro.
Observaciones
El función NdisEnumerateFilterModules devuelve una estructura NDIS_FILTER_INTERFACE para cada filtro de la pila de controladores. El miembro Flags identifica el filtro como un controlador intermedio NDIS 5.1 o un controlador intermedio de filtro anterior o un módulo de filtro NDIS 6.0 o posterior.
Un filtro ligero puede insertar o quitarse dinámicamente de la ruta de acceso de envío o recepción llamando a NdisFRestartFilter y proporcionando una estructura de NDIS_FILTER_PARTIAL_CHARACTERISTICS para NdisSetOptionalHandlers.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Se admite en NDIS 6.0 y versiones posteriores. |
| encabezado de | ndis.h (incluya Ndis.h) |