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

Статья
02/07/2025

Структура NDIS_QOS_CAPABILITIES указывает возможности NDIS Quality of Service (QoS) сетевого адаптера, поддерживающего интерфейс 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.

Драйвер минипорта должен задать для элемента типазаголовка значение 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 QoS, поддерживаемые сетевым адаптером. Определены следующие флаги:

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). Эти протоколы включают набор протоколов Конвергентного расширенного Ethernet (CEE).

NDIS_QOS_CAPABILITIES_IEEE_DCBX_SUPPORTED

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

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

MaxNumTrafficClasses

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

Примечание Чтобы сетевой адаптер поддерживал 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 базового сетевого адаптера из функции miniportInitializeEx драйвера, выполнив следующие действия.

Минипорт-драйвер инициализирует структуру NDIS_QOS_CAPABILITIES с NDIS QoS сетевым адаптером.
Мини-драйвер инициализирует структуру 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 (include Ndis.h)