estructura NDIS_HD_SPLIT_ATTRIBUTES (ndis.h)

2025-02-07

La estructura NDIS_HD_SPLIT_ATTRIBUTES define los atributos de división de datos de encabezado, si los hay, que están asociados a un adaptador de miniport.

Sintaxis

typedef struct _NDIS_HD_SPLIT_ATTRIBUTES {
  NDIS_OBJECT_HEADER Header;
  ULONG              HardwareCapabilities;
  ULONG              CurrentCapabilities;
  ULONG              HDSplitFlags;
  ULONG              BackfillSize;
  ULONG              MaxHeaderSize;
} NDIS_HD_SPLIT_ATTRIBUTES, *PNDIS_HD_SPLIT_ATTRIBUTES;

Miembros

Header

Estructura NDIS_OBJECT_HEADER para la estructura de características del proveedor (NDIS_HD_SPLIT_ATTRIBUTES). El controlador establece el miembro type de de la estructura que encabezado especifica para NDIS_OBJECT_TYPE_HD_SPLIT_ATTRIBUTES, el miembro Revision en NDIS_OBJECT_HD_SPLIT_ATTRIBUTES_REVISION_1 y el miembro Size en NDIS_SIZEOF_HD_SPLIT_ATTRIBUTES_REVISION_1.

HardwareCapabilities

Las funcionalidades de hardware de división de datos de encabezado que admite el adaptador de miniporte. Estas funcionalidades deben incluir funcionalidades que están deshabilitadas actualmente por la configuración del archivo INF o a través de la página de propiedades avanzadas de. El valor de HardwareCapabilities es un OR bit a bit de las marcas siguientes:

NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT

El adaptador de miniporte puede dividir el encabezado y los datos en MDL independientes que cumplan los requisitos de compatibilidad con la división de datos de encabezado.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV4_OPTIONS

El adaptador de minipuerto puede dividir fotogramas Ethernet IPv4 que incluyen opciones IPv4. El adaptador de miniporte puede admitir la división de algunas opciones de IPv4 mientras no se dividen otras.

Nota La NIC no debe dividir fotogramas IPv4 que contengan opciones IPv4 no admitidas. Si se divide un marco IPv4, la parte de encabezado del marco dividido debe contener el encabezado IPv4 completo y todas las opciones IPv4 que están presentes.

NDIS_HD_SPLIT_CAPS_SUPPORTS_IPV6_EXTENSION_HEADERS

El adaptador de miniporte puede dividir fotogramas Ethernet IPv6 que incluyen encabezados de extensión IPv6. El adaptador de miniporte puede admitir algunos encabezados de extensión IPv6, mientras que no admiten otros.

Nota La NIC no debe dividir fotogramas IPv6 que contengan encabezados de extensión IPv6 no admitidos. Si se divide un marco IPv6, la parte de encabezado del marco dividido debe contener todo el encabezado IPv6 y todos los encabezados de extensión IPv6 que están presentes.

NDIS_HD_SPLIT_CAPS_SUPPORTS_TCP_OPTIONS

El adaptador de miniporte puede dividir fotogramas TCP con otras opciones TCP además de la opción de marca de tiempo. El adaptador de miniporte puede admitir algunas opciones TCP y no admitir otras.

Nota Si la única opción TCP de un marco es la opción timestamp, el proveedor de división de datos debe poder dividir el marco.

Nota Si un encabezado TCP contiene una opción TCP no admitida, la NIC debe dividir el marco al principio del encabezado TCP o no debe dividir el marco.

CurrentCapabilities

Las funcionalidades actuales de división de datos de encabezado que admite el adaptador de miniporte. El controlador miniport usa las mismas marcas definidas para el miembro HardwareCapabilities. En este caso, las marcas se establecen para indicar las funcionalidades actuales que dependen de las opciones de configuración actuales.

HDSplitFlags

Conjunto de marcas que controlan el estado de división de datos de encabezado para un adaptador de miniporte. El controlador de miniport debe establecer este miembro en cero antes de llamar a función NdisMSetMiniportAttributes. Después de NdisMSetMiniportAttributes devuelve correctamente, el controlador debe comprobar las marcas y configurar el hardware en consecuencia. NDIS establece este miembro con un OR bit a bit de las marcas siguientes:

NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT

Si se establece esta marca, el controlador de miniport debe habilitar la división de datos de encabezado en el hardware. De lo contrario, la división de datos de encabezado está deshabilitada. Si el equipo usa la división de datos de encabezado y el controlador de miniportar también establece la marca de NDIS_HD_SPLIT_CAPS_SUPPORTS_HEADER_DATA_SPLIT en el miembro CurrentCapabilities, NDIS establece NDIS_HD_SPLIT_ENABLE_HEADER_DATA_SPLIT.

BackfillSize

Tamaño de reposición, en bytes, para la parte de datos de un marco dividido. El controlador de miniport debe establecerse
BackfillSize a cero antes de llamar a NdisMSetMiniportAttributes. NDIS establece este miembro si el controlador de minipuerto debe asignar previamente el almacenamiento de reposición en la parte de datos para fotogramas divididos. Después de NdisMSetMiniportAttributes devuelve correctamente, el controlador debe usar el valor de BackfillSize que NDIS estableció para asignar previamente los búferes de datos.

MaxHeaderSize

Tamaño máximo, en bytes, para la parte de encabezado de un marco dividido. El controlador de miniport debe establecer MaxHeaderSize en cero antes de llamar a NdisMSetMiniportAttributes. NDIS establece este miembro en el tamaño máximo del búfer de encabezado para fotogramas divididos. Después de NdisMSetMiniportAttributes devuelve correctamente, el controlador debe usar el valor proporcionado por NDIS.

Nota Si la longitud de un encabezado supera MaxHeaderSize debido a la presencia de opciones IPv4, encabezados IPSec o encabezados de extensión IPv6, el marco no debe dividirse. Si un encabezado que incluye un encabezado TCP o UDP supera MaxHeaderSize debido a la presencia de encabezado TCP, opciones TCP o encabezado UDP, la NIC debe dividir el marco al principio del encabezado del protocolo de capa superior o no debe dividir el marco.

Observaciones

Para admitir la división de datos de encabezado, un controlador de miniporte pasa un puntero a un estructura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES en el parámetro MiniportAttributes del parámetro función NdisMSetMiniportAttributes. El miembro HDSplitAttributes de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES contiene un puntero a la estructura NDIS_HD_SPLIT_ATTRIBUTES. Un controlador de miniport llama a NdisMSetMiniportAttributes desde su función MiniportInitializeEx durante la inicialización.