структура NDIS_QOS_CAPABILITIES (ntddndis.h)

Статья
08/07/2023

Структура NDIS_QOS_CAPABILITIES определяет возможности качества обслуживания (QoS) NDIS сетевого адаптера, поддерживающего интерфейс IEEE 802.1 Data Center Bridging (DCB).

Синтаксис

typedef struct _NDIS_QOS_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              MaxNumTrafficClasses;
  ULONG              MaxNumEtsCapableTrafficClasses;
  ULONG              MaxNumPfcEnabledTrafficClasses;
} NDIS_QOS_CAPABILITIES, *PNDIS_QOS_CAPABILITIES;

Члены

Header

Тип, редакция и размер структуры NDIS_QOS_CAPABILITIES . Этот элемент имеет формат структуры NDIS_OBJECT_HEADER .

Драйвер мини-порта должен задать для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_QOS_CAPABILITIES. Чтобы указать версию структуры NDIS_QOS_CAPABILITIES , драйвер должен задать для члена Редакциизаголовка следующее значение:

NDIS_QOS_CAPABILITIES_REVISION_1

Исходная версия для NDIS 6.30 и более поздних версий.

Задайте для элемента Размер значение NDIS_SIZEOF_QOS_CAPABILITIES_REVISION_1.

Flags

Значение ULONG , содержащее побитовое ИЛИ флагов, которые указывают возможности качества обслуживания NDIS, поддерживаемые сетевым адаптером. Определены следующие флаги:

NDIS_QOS_CAPABILITIES_STRICT_TSA_SUPPORTED

Если этот флаг установлен, сетевой адаптер поддерживает алгоритм выбора передачи строгого приоритета (TSA). Дополнительные сведения об этом алгоритме см. в разделе Алгоритм строгого приоритета.

Примечание Чтобы обеспечить соответствие dcb, сетевой адаптер должен поддерживать TSA строгого приоритета.

NDIS_QOS_CAPABILITIES_MACSEC_BYPASS_SUPPORTED

Если этот флаг установлен, сетевой адаптер поддерживает возможность обхода обработки управления доступом к мультимедиа (MACsec). Дополнительные сведения о MACsec см. в стандарте 802.1AE-2006.

NDIS_QOS_CAPABILITIES_CEE_DCBX_SUPPORTED

Если этот флаг установлен, сетевой адаптер и драйвер мини-порта поддерживают протоколы, предшествующие протоколу IEEE 802.1Qaz Data Center Bridging Exchange (DCBX). Эти протоколы включают в себя набор протоколов Converged Enhanced Ethernet (CEE).

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

Если этот флаг установлен, сетевой адаптер и драйвер мини-порта поддерживают протокол DCBX IEEE 802.1Qaz. Протокол DCBX позволяет обмениваться параметрами DCB между двумя напрямую подключенными одноранговых узлами. Это позволяет этим одноранговым узлам адаптировать и настроить эти параметры, чтобы оптимизировать передачу данных через подключение. Дополнительные сведения об этом протоколе см. в статье Обзор моста центра обработки данных.

Примечание Если этот флаг установлен, драйвер мини-порта должен отклонять все запросы на отправку пакетов DCBX.

MaxNumTrafficClasses

Значение ULONG , указывающее максимальное количество классов трафика QoS NDIS, поддерживаемых сетевым адаптером. Дополнительные сведения см. в разделе Классы трафика NDIS QoS.

Примечание Чтобы сетевой адаптер поддерживал NDIS QoS для DCB, он должен поддерживать по крайней мере три класса трафика.

MaxNumEtsCapableTrafficClasses

Значение ULONG , указывающее максимальное количество классов трафика QoS, которые сетевой адаптер может использовать с алгоритмом расширенного выбора передачи (ETS). Это значение должно быть меньше или равно значению элемента MaxNumTrafficClasses .

Дополнительные сведения о ETS см. в разделе Алгоритм расширенного выбора передачи (ETS).

Примечание Чтобы сетевой адаптер поддерживал NDIS QoS для DCB, он должен поддерживать по крайней мере два класса трафика с поддержкой ETS.

MaxNumPfcEnabledTrafficClasses

Значение ULONG , указывающее максимальное количество классов трафика QoS, которое сетевой адаптер может использовать с алгоритмом управления потоком на основе приоритета (PFC). Это значение должно быть меньше или равно значению элемента MaxNumTrafficClasses .

Дополнительные сведения о PFC см. в разделе Управление потоком на основе приоритета (PFC).

Примечание Чтобы сетевой адаптер поддерживал NDIS QoS для DCB, он должен поддерживать по крайней мере один класс трафика с поддержкой PFC.

Драйвер мини-порта инициализирует структуру NDIS_QOS_CAPABILITIES с помощью возможностей качества обслуживания NDIS сетевого адаптера.
Драйвер мини-порта инициализирует структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES с другими аппаратными возможностями сетевого адаптера. Драйвер задает элемент HardwareQosCapabilities структуры NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES указателем на структуру NDIS_QOS_CAPABILITIES .
Драйвер мини-порта вызывает NdisMSetMiniportAttributes и задает параметру MiniportAttributes указатель на структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Структура NDIS_QOS_CAPABILITIES также возвращается в запросах OID OID_QOS_CURRENT_CAPABILITIES и OID_QOS_HARDWARE_CAPABILITIES.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.30 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)