Поделиться через


OID_QOS_PARAMETERS

Компонент центра обработки данных (DCB) (Msdcb.sys) выдает запрос метода идентификатора объекта (OID) OID_QOS_PARAMETERS для настройки локальных NDIS Quality of Service (QoS) в сетевом адаптере.

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_QOS_PARAMETERS.

Примечание Этот запрос метода OID является обязательным для мини-портов драйверов, поддерживающих NDIS QoS для интерфейса IEEE 802.1 Data Center Bridging (DCB).

Замечания

Драйверы минипорта получают локальные параметры качества качества обслуживания NDIS с помощью запроса метода OID OID_QOS_PARAMETERS. Эти параметры определяют, как сетевой адаптер определяет приоритет передачи или исходящихпакетов. Дополнительные сведения об этих параметрах см. в обзор NDIS QoS Parameters.

примечание Только компонент DCB может выдавать запрос метода OID OID_QOS_PARAMETERS. Не следует выдавать этот идентификатор OID. Дополнительные сведения о компоненте DCB см. в архитектуре качества обслуживания NDIS для центра обработки данных.

Компонент DCB выдает запрос OID_QOS_PARAMETERS в следующих условиях:

  • Системный администратор устанавливает или удаляет компонент сервера Microsoft DCB.

    Дополнительные сведения о функции сервера DCB см. в System-Provided компонентах DCB.

  • Системный администратор включает или отключает компонент сервера DCB во время установки компонента.

  • Системный администратор изменяет любой из параметров функции сервера DCB.

  • Операционная система запускается или перезапускается при установке компонента сервера DCB.

Когда драйвер минипорта обрабатывает запрос метода OID OID_QOS_PARAMETERS, он должен соответствовать следующим рекомендациям:

  • Драйвер минипорта копирует данные в структуре NDIS_QOS_PARAMETERS в кэш локальных ndiS QoS. Затем драйвер разрешает свои операционные параметры NDIS QoS на основе его кэша локальных параметров качества качества обслуживания NDIS и его кэша NDIS QoS параметров, полученных от удаленного однорангового узла.

    Дополнительные сведения о том, как драйвер минипорта разрешает свои операционные параметры, см. в разрешении параметров QoS операционных NDIS.

  • Минипорт-драйвер не должен изменять данные, содержащиеся в структуре NDIS_QOS_PARAMETERS. Драйвер должен завершить запрос метода OID и вернуть исходные данные в NDIS_QOS_PARAMETERS структуре.

  • Флаг NDIS_QOS_PARAMETERS_WILLING указывает, включает ли драйвер минипорта или отключает состояние готовности локального центра обработки данных Exchange (DCBX). Драйвер обрабатывает этот флаг следующим образом:

    • Если этот флаг задан, минипорт-драйвер должен включить локальное состояние DCBX Willing. Это позволяет удаленно настроить драйвер с параметрами QoS. В этом случае драйвер разрешает свои операционные параметры качества обслуживания на основе удаленных параметров QoS. Минипорт-драйвер также может разрешать свои операционные параметры качества обслуживания на основе любых параметров качества обслуживания, определенных независимым поставщиком оборудования (IHV).

    • Если этот флаг не задан, драйвер минипорта должен отключить локальное состояние DCBX Willing. Это позволяет драйверу разрешать свои операционные параметры QoS из локальных параметров качества обслуживания, а не удаленных параметров качества обслуживания. Драйвер минипорта также должен отключить или переопределить любой локальный параметр QoS, для которого не задан соответствующий флаг NDIS_QOS_PARAMETERS_Xxx_CONFIGURED.

      Например, минипорт-драйвер может переопределить ненастройанный локальный параметр QoS с собственными параметрами для параметра QoS, определенного IHV. Если нет собственных параметров для локальных параметров качества обслуживания, которые не указаны с флагом NDIS_QOS_PARAMETERS_XXX_CONFIGURED, драйвер должен отключить использование этих параметров качества обслуживания в сетевом адаптере.

      Примечание Драйвер также может переопределить локальные параметры качества обслуживания, если они компрометируют параметры качества обслуживания, используемые протоколами или технологиями, включенными в сетевом адаптере. Например, драйвер может переопределить локальные параметры качества обслуживания, если сетевой адаптер включен для удаленной загрузки через протокол Fibre Channel через Ethernet (FCoE).

    Дополнительные сведения о локальном состоянии DCBX Willing см. в управлении локальным состоянием готовности DCBX.

Дополнительные сведения о переопределении локальных параметров QoS драйвера минипорта см. в разделе Управление параметрами качества обслуживания NDIS.

Примечание Переопределение локальных параметров качества обслуживания не должно привести к сбою запроса метода OID OID_QOS_PARAMETERS.

Дополнительные сведения о том, как драйвер минипорта управляет локальными параметрами качества обслуживания, см. в разделе Настройка параметров NDIS QoS.

Коды состояния возврата

Минипорт-драйвер возвращает один из следующих кодов состояния.

Код состояния Описание

NDIS_STATUS_SUCCESS

Запрос OID успешно завершен.

NDIS_STATUS_PENDING

Запрос OID ожидает завершения. Когда драйвер минипорта вызывает NdisMOidRequestComplete, NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающего объекта после завершения запроса.

NDIS_STATUS_NOT_SUPPORTED

Минипорт-драйвер не поддерживает интерфейс качества обслуживания NDIS.

NDIS_STATUS_INVALID_PARAMETER

Один или несколько элементов структуры NDIS_QOS_PARAMETERS содержат неправильные значения.

NDIS_STATUS_INVALID_LENGTH

Длина буфера информации меньше размера(NDIS_QOS_PARAMETERS). NDIS задает DATA. QUERY_INFORMATION. Элемент BytesNeeded в структуре NDIS_OID_REQUEST к минимальному размеру буфера, который требуется.

NDIS_STATUS_FAILURE

Запрос завершился ошибкой по другим причинам.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

Ntddndis.h (include Ndis.h)

См. также


NdisMOidRequestComplete

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE