OID_QOS_REMOTE_PARAMETERS

Статья
2025-03-13

Переопределяющий драйвер выдает запрос запроса идентификатора объекта (OID) OID_QOS_REMOTE_PARAMETERS для получения параметров качества обслуживания (QoS) NDIS для удаленного однорангового узла. Минипорт-драйвер использует эти удаленные параметры качества обслуживания для разрешения своих операционных NDIS параметров качества обслуживания. Драйвер настраивает сетевой адаптер с операционными параметрами для передачи пакетов QoS.

После успешного возврата из запроса OID InformationBuffer член структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_QOS_PARAMETERS.

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

Замечания

Когда NDIS обрабатывает запрос OID OID_QOS_REMOTE_PARAMETERS успешно, он возвращает удаленные параметры QoS NDIS, кэшированные из предыдущей NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE состояния, которые были выданы мини-драйвером минипорта. Драйвер выдает это состояние, чтобы сообщить о начальном наборе параметров качества обслуживания NDIS. Драйвер также выдает это состояние, указывая при изменении параметров удаленного качества обслуживания NDIS.

NDIS возвращает NDIS_QOS_PARAMETERS структуру, которая инициализирована следующим образом:

Если минипорт-драйвер ранее выпустил указание состояния NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, NDIS кэширует данные NDIS_QOS_PARAMETERS и возвращает эти данные для запроса запроса OID OID_QOS_REMOTE_PARAMETERS.
Если драйвер минипорта не выдает указание состояния NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, NDIS возвращает структуру NDIS_QOS_PARAMETERS со всеми элементами (за исключением элемента заголовка) равным нулю.

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

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

NDIS возвращает один из следующих кодов состояния.

Код состояния	Описание
NDIS_STATUS_SUCCESS	Запрос OID успешно завершен.
NDIS_STATUS_NOT_SUPPORTED	Минипорт-драйвер не поддерживает интерфейс качества обслуживания NDIS.
NDIS_STATUS_INVALID_LENGTH	Длина буфера информации меньше размера (NDIS_QOS_PARAMETERS). NDIS задает DATA. QUERY_INFORMATION. Элемент BytesNeeded в структуре NDIS_OID_REQUEST к минимальному размеру буфера, который требуется.
NDIS_STATUS_FAILURE	Запрос завершился ошибкой по другим причинам.