OID_QOS_PARAMETERS
Компонент мостового центра обработки данных (Msdcb.sys) отправляет запрос метода идентификатора объекта (OID) OID_QOS_PARAMETERS для настройки локальных параметров качества обслуживания (QoS) NDIS на сетевом адаптере.
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_QOS_PARAMETERS .
Примечание Этот запрос метода OID является обязательным для драйверов miniport, поддерживающих QoS NDIS для интерфейса IEEE 802.1 Data Center Bridging (DCB).
Комментарии
Драйверы минипорта получают локальные параметры качества обслуживания NDIS с помощью запроса метода OID OID_QOS_PARAMETERS. Эти параметры определяют, как сетевой адаптер определяет приоритет передающих или исходящих пакетов. Дополнительные сведения об этих параметрах см. в статье Обзор параметров качества обслуживания NDIS.
Примечание Только компонент DCB может выдавать запрос метода OID OID_QOS_PARAMETERS. Драйвер избыточного протокола или фильтра не должен выдавать этот идентификатор идентификатора. Дополнительные сведения о компоненте DCB см. в статье NDIS QoS Architecture for Data Center Bridging.
Компонент DCB отправляет запрос OID_QOS_PARAMETERS при следующих условиях:
Системный администратор устанавливает или удаляет компонент сервера Microsoft DCB.
Дополнительные сведения о функции сервера DCB см. в разделе Компоненты DCB, предоставляемые системой.
Системный администратор включает или отключает компонент сервера DCB во время установки компонента.
Системный администратор изменяет любой из параметров компонента сервера DCB.
Операционная система запускается или перезапускается во время установки компонента сервера DCB.
Когда драйвер мини-порта обрабатывает запрос метода OID OID_QOS_PARAMETERS, он должен следовать следующим рекомендациям:
Драйвер мини-порта копирует данные из структуры NDIS_QOS_PARAMETERS в кэш локальных параметров качества обслуживания NDIS. Затем драйвер разрешает свои операционные параметры качества обслуживания NDIS на основе кэша локальных параметров качества обслуживания NDIS и кэша параметров качества обслуживания NDIS, полученных от удаленного однорангового узла.
Дополнительные сведения о том, как драйвер минипорта разрешает свои рабочие параметры, см. в разделе Resolveing Operational NDIS QoS Parameters.
Драйвер мини-порта не должен изменять данные, содержащиеся в структуре NDIS_QOS_PARAMETERS . Драйвер должен выполнить запрос метода OID и вернуть исходные данные в структуре NDIS_QOS_PARAMETERS .
Флаг NDIS_QOS_PARAMETERS_WILLING указывает, включает или отключает драйвер мини-порта состояние готовности локального центра обработки данных (DCBX). Драйвер обрабатывает этот флаг следующим образом:
Если этот флаг установлен, драйвер мини-порта должен включить локальное состояние готовности DCBX. Это позволяет удаленно настроить драйвер с параметрами качества обслуживания. В этом случае драйвер разрешает свои рабочие параметры качества обслуживания на основе параметров удаленного качества обслуживания. Драйвер мини-порта также может разрешать свои операционные параметры качества обслуживания на основе любых собственных параметров качества обслуживания, определенных независимым поставщиком оборудования (IHV).
Если этот флаг не установлен, драйвер мини-порта должен отключить локальное состояние готовности DCBX. Это позволяет драйверу разрешать свои операционные параметры QoS из локальных параметров QoS, а не из параметров удаленного качества обслуживания. Драйвер мини-порта также должен отключить или переопределить любой локальный параметр QoS, для которого не установлен соответствующий флаг NDIS_QOS_PARAMETERS_Xxx_CONFIGURED .
Например, драйвер минипорта может переопределить ненастроенный локальный параметр QoS своими собственными параметрами для параметра QoS, определенного IHV. Если для локальных параметров качества обслуживания отсутствуют собственные параметры, которые не указаны с флагом NDIS_QOS_PARAMETERS_Xxx_CONFIGURED , драйвер должен отключить использование этих параметров качества обслуживания в сетевом адаптере.
Примечание Драйвер также может переопределить настроенные локальные параметры качества обслуживания, если они скомпрометируют параметры качества обслуживания, используемые протоколами или технологиями, включенными в сетевом адаптере. Например, драйвер может переопределить локальные параметры качества обслуживания, если сетевой адаптер включен для удаленной загрузки по протоколу Fibre Channel over Ethernet (FCoE).
Дополнительные сведения о локальном состоянии ГОТОВНОСТИ DCBX см. в разделе Управление локальным состоянием готовности DCBX.
Дополнительные сведения о том, как драйвер мини-порта переопределяет локальные параметры качества обслуживания, см. в разделе Управление параметрами качества обслуживания NDIS.
Примечание Переопределение локальных параметров качества обслуживания не должно привести к сбою драйвера мини-порта при выполнении запроса метода OID OID_QOS_PARAMETERS.
Дополнительные сведения о том, как драйвер мини-порта управляет локальными параметрами качества обслуживания, см. в разделе Настройка локальных параметров качества обслуживания NDIS.
Коды состояния возврата
Драйвер мини-порта возвращает один из следующих кодов состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
NDIS_STATUS_PENDING |
Запрос OID ожидает завершения. Когда драйвер минипорта вызывает NdisMOidRequestComplete, NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающей стороны после завершения запроса. |
NDIS_STATUS_NOT_SUPPORTED |
Драйвер мини-порта не поддерживает интерфейс QoS NDIS. |
NDIS_STATUS_INVALID_PARAMETER |
Один или несколько элементов структуры NDIS_QOS_PARAMETERS содержат неверные значения. |
NDIS_STATUS_INVALID_LENGTH |
Длина информационного буфера меньше , чем sizeof(NDIS_QOS_PARAMETERS). NDIS задает значение DATA. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера. |
NDIS_STATUS_FAILURE |
Сбой запроса по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |