estructura NDIS_QOS_PARAMETERS (ntddndis.h)

Artículo
08/07/2023

La estructura NDIS_QOS_PARAMETERS especifica los parámetros de calidad de servicio (QoS) de NDIS que están habilitados en un adaptador de red que admite la interfaz ieee 802.1 de puente del centro de datos (DCB).

Sintaxis

typedef struct _NDIS_QOS_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              NumTrafficClasses;
  UCHAR              PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES];
  UCHAR              TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  UCHAR              TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES];
  ULONG              PfcEnable;
  ULONG              NumClassificationElements;
  ULONG              ClassificationElementSize;
  ULONG              FirstClassificationElementOffset;
} NDIS_QOS_PARAMETERS, *PNDIS_QOS_PARAMETERS;

Miembros

Header

Tipo, revisión y tamaño de la estructura NDIS_QOS_PARAMETERS . Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .

El controlador de minipuerto debe establecer el miembro Type de Header en NDIS_OBJECT_TYPE_QOS_PARAMETERS. Para especificar la versión de la estructura de NDIS_QOS_PARAMETERS , el controlador debe establecer el miembro Revision de Header en el siguiente valor:

NDIS_QOS_PARAMETERS_REVISION_1

Versión original para NDIS 6.30 y versiones posteriores.

Establezca el miembro Size en NDIS_SIZEOF_QOS_PARAMETERS_REVISION_1.

Flags

Valor ULONG que contiene un OR bit a bit de marcas que especifican el estado de los parámetros QoS de NDIS para el adaptador de red. Para obtener más información sobre este miembro, vea Información general del miembro Flags.

NumTrafficClasses

Valor de ULONG que especifica el número de clases de tráfico QoS de NDIS que están habilitadas en el adaptador de red. Cada clase de tráfico se hace referencia a través de un identificador en el intervalo de cero a (NumTrafficClasses–1).

Nota El valor del miembro NumTrafficClasses debe ser menor o igual que min(NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES, MaxNumTrafficClasses), donde MaxNumTrafficClasses es el valor del miembro MaxNumTrafficClasses especificado en la estructura NDIS_QOS_CAPABILITIES .

PriorityAssignmentTable[NDIS_QOS_MAXIMUM_PRIORITIES]

Matriz de elementos UCHAR donde cada elemento representa la clase de tráfico asociada a un nivel de prioridad IEEE 802.1p. La matriz PriorityAssignmentTable se indexa mediante el nivel de prioridad 802.1p (0–7).

Cada elemento contiene el identificador de clase de tráfico. Este identificador es el índice de la estructura NDIS_QOS_CLASSIFICATION_ELEMENT de la clase de tráfico dentro de la matriz de clasificación.

Nota A cada elemento de la matriz PriorityAssignmentTable se le debe asignar un identificador de clase de tráfico válido. Se puede asignar un identificador de clase de tráfico a más de un elemento de la matriz PriorityAssignmentTable .

TcBandwidthAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Matriz de elementos UCHAR que especifica el porcentaje de asignación de ancho de banda asignado a cada clase de tráfico. La matriz TcBandwidthAssignmentTable se indexa mediante el identificador de clase de tráfico.

Cada elemento de la matriz TcBandwidthAssignmentTable especifica la asignación de ancho de banda para las clases de tráfico. El valor total de todas las asignaciones de asignación de ancho de banda en la matriz TcBandwidthAssignmentTable debe ser igual a 100.

Nota La asignación de ancho de banda solo se admite para el TSA de selección de transmisión mejorada (ETS). Si el elemento de la clase de tráfico de la matriz TsaAssignmentTable no está establecido en NDIS_QOS_TSA_ETS, el elemento de la clase de tráfico de la matriz TcBandwidthAssignmentTable debe establecerse en cero.

TsaAssignmentTable[NDIS_QOS_MAXIMUM_TRAFFIC_CLASSES]

Matriz de elementos UCHAR que especifica el TSA asignado a cada clase de tráfico. La matriz TsaAssignmentTable se indexa mediante el identificador de clase de tráfico.

Cada elemento de la matriz TsaAssignmentTable contiene uno de los siguientes valores:

NDIS_QOS_TSA_STRICT

El algoritmo de prioridad estricta debe usarse como TSA para la clase de tráfico. Para obtener más información sobre este TSA, vea Strict Priority Algorithm.

NDIS_QOS_TSA_CBS

El algoritmo de conformador basado en crédito (CBS) IEEE 802.1Qav debe usarse como TSA para la clase de tráfico.

Nota A partir de Windows Server 2012, el componente DCB (Msdcb.sys) no admite el TSA de CBS y no habilitará este parámetro a través de solicitudes de método de identificador de objeto (OID) de OID_QOS_PARAMETERS. Para obtener más información sobre el componente DCB, consulte Arquitectura de QoS de NDIS para el puente del centro de datos.

NDIS_QOS_TSA_ETS

El algoritmo IEEE 802.1Qaz Enhanced Transmission Selection (ETS) debe usarse como TSA para la clase de tráfico. Para obtener más información sobre este TSA, vea Algoritmo de selección de transmisión mejorada (ETS).

PfcEnable

Mapa de bits de 32 bits. Los 24 bits más significativos están reservados para uso futuro. Los 8 bits menos significativos se usan para especificar si PFC está habilitado en el nivel de prioridad IEEE 802.1p. Si el bit se establece en uno, PFC está habilitado para el nivel de prioridad.

Intervalo de bits	Significado
31:24	Reservado para uso futuro.
7	Si se establece en uno, PFC está habilitado en el nivel de prioridad 7 (control de red) de 802.1p.
6	Si se establece en uno, PFC está habilitado en el nivel de prioridad 6 de 802.1p (control internetwork).
5	Si se establece en uno, PFC está habilitado en el nivel de prioridad 5 (voz) de 802.1p.
4	Si se establece en uno, PFC está habilitado en el nivel de prioridad 4 (vídeo) de 802.1p.
3	Si se establece en uno, PFC está habilitado en el nivel de prioridad 3 de 802.1p (aplicaciones críticas).
2	Si se establece en uno, PFC está habilitado en el nivel de prioridad 2 de 802.1p (excelente esfuerzo).
1	Si se establece en uno, PFC está habilitado en el nivel de prioridad 1 de 802.1p (en segundo plano).
0	Si se establece en uno, PFC está habilitado en el nivel de prioridad 0 de 802.1p (mejor esfuerzo).

Nota El número total de niveles de prioridad de 802,1p que tienen habilitado PFC debe ser menor o igual que el valor del miembro MaxNumPfcEnabledTrafficClasses de la estructura NDIS_QOS_CAPABILITIES .

Para obtener más información sobre los niveles de prioridad, consulte Ieee 802.1p Priority Levels.

NumClassificationElements

Valor de ULONG que especifica el número de elementos de la matriz de clasificación de tráfico. El desplazamiento al primer elemento de esta matriz se especifica mediante el miembro FirstClassificationElementOffset .

Nota Cada elemento de la matriz tiene el formato de estructura NDIS_QOS_CLASSIFICATION_ELEMENT .

ClassificationElementSize

Valor de ULONG que especifica el tamaño, en bytes, de cada elemento de la matriz de clasificación de tráfico.

Nota A partir de NDIS 6.30, este miembro debe establecerse sizeof(NDIS_QOS_CLASSIFICATION_ELEMENTen ).

FirstClassificationElementOffset

Valor de ULONG que especifica el desplazamiento, en bytes, al primer elemento de una matriz de elementos de clasificación de tráfico que siguen esta estructura. El desplazamiento se mide desde el principio de la estructura NDIS_QOS_PARAMETERS hasta el principio del primer elemento. Cada elemento de la matriz es una estructura NDIS_QOS_CLASSIFICATION_ELEMENT .

Nota Si NumClassificationElements se establece en cero, se omite este miembro.

Comentarios

La estructura NDIS_QOS_PARAMETERS especifica los parámetros que definen cómo el adaptador de red da prioridad a la transmisión, o salida, los paquetes. Esta estructura se usa en las siguientes solicitudes de OID:

Solicitud de consulta de OID de OID_QOS_OPERATIONAL_PARAMETERS. Esta solicitud de OID devuelve los parámetros de QoS operativos que se aprovisionan actualmente en el adaptador de red.
Solicitud de consulta OID de OID_QOS_REMOTE_PARAMETERS. Esta solicitud de OID devuelve los parámetros de QoS remotos que se aprovisionan actualmente en el adaptador de red.
Solicitudes de método OID de OID_QOS_PARAMETERS. Esta solicitud de OID aprovisiona el adaptador de red con los parámetros de QoS locales.

El controlador de minipuerto también devuelve una estructura NDIS_QOS_PARAMETERS en las siguientes indicaciones de estado NDIS:

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE. Este controlador de minipuerto emite esta indicación de estado cuando cambian sus parámetros de QoS operativos.
NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE. Este controlador de minipuerto emite esta indicación de estado cuando cambian sus parámetros de QoS remotos.

Para obtener más información sobre los tipos de parámetros QoS de NDIS, vea Información general de los parámetros de QoS de NDIS.

Información general del miembro Flags

El miembro Flags contiene un OR bit a bit de marcas que especifican el estado de los parámetros QoS de NDIS para el adaptador de red.

El controlador de minipuerto establece el miembro Flags cuando emite las siguientes indicaciones de estado NDIS:

El componente DCB establece el miembro Flags cuando emite una solicitud de método OID de OID_QOS_PARAMETERS.

Nota Solo el componente DCB puede emitir la solicitud OID. Un controlador de filtro o protocolo demasiado excesivo no debe emitir este OID. Para obtener más información sobre el componente DCB, consulte Arquitectura de QoS de NDIS para el puente del centro de datos.

Las marcas siguientes se definen para el miembro Flags .

Nota NDIS garantiza que las marcas NDIS_QOS_PARAMETERS_ETS_CONFIGURED y NDIS_QOS_PARAMETERS_PFC_CONFIGURED se establecen o borran juntas.

Las marcas NDIS_QOS_PARAMETERS_Xxx_CHANGED proporcionan sugerencias sobre si el grupo de parámetros correspondiente ha cambiado de una solicitud de método de OID_QOS_PARAMETERS anterior o NDIS_QOS_PARAMETERS_Xxx_CHANGED notificación de estado. Cuando el controlador de minipuerto emite las notificaciones de estado NDIS_QOS_PARAMETERS_Xxx_CHANGED , también puede establecer estas marcas.

Nota Si no se establecen las marcas NDIS_QOS_PARAMETERS_Xxx_CHANGED , no se deben suponer que el grupo de parámetros correspondiente es compatible o habilitado en el adaptador de red subyacente.