OID_NIC_SWITCH_CURRENT_CAPABILITIES

  • Статья

Избыточный драйвер отправляет запрос на запрос идентификатора объекта (OID) OID_NIC_SWITCH_CURRENT_CAPABILITIES для получения включенных в данный момент аппаратных возможностей коммутатора сетевой карты в сетевом адаптере.

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

Комментарии

Начиная с версии NDIS 6.20 драйверы miniport предоставляют аппаратные возможности коммутатора сетевого адаптера, включенные в данный момент, при вызове его функции MiniportInitializeEx . Драйвер инициализирует структуру NDIS_NIC_SWITCH_CAPABILITIES с аппаратными возможностями коммутатора сетевой карты и задает элемент CurrentNicSwitchCapabilities структуры NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES указателем на структуру NDIS_NIC_SWITCH_CAPABILITIES . Затем драйвер мини-порта вызывает функцию NdisMSetMiniportAttributes и задает параметру MiniportAttributes указатель на структуру NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .

Примечание Начиная с версии NDIS 6.30, драйверы минипорта, поддерживающие интерфейс sr-IOV, должны регистрировать включенные аппаратные возможности коммутатора сетевой карты. Драйверы регистрируют эти возможности, вызывая NdisMSetMiniportAttributes.

При превышении драйверов протоколов и фильтров не нужно выдавать запросы OID OID_NIC_SWITCH_CURRENT_CAPABILITIES. NDIS предоставляет аппаратные возможности коммутатора сетевого адаптера для этих драйверов следующим образом:

  • NDIS сообщает о включенных в настоящее время аппаратных возможностях коммутатора сетевой карты базового сетевого адаптера в драйверах протоколов в элементе NicSwitchCapabilitiesструктуры NDIS_BIND_PARAMETERS во время операции привязки.

  • NDIS сообщает о включенных в данный момент аппаратных возможностях коммутатора сетевой карты базового сетевого адаптера в сверхлежащих драйверах фильтров в члене NicSwitchCapabilitiesструктуры NDIS_FILTER_ATTACH_PARAMETERS во время операции присоединения.

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

NDIS обрабатывает запрос OID OID_NIC_SWITCH_CURRENT_CAPABILITIES запроса для драйверов минипорта. Драйверы не будут выдавать этот запрос OID.

Когда NDIS обрабатывает запрос OID_NIC_SWITCH_CURRENT_CAPABILITIES, он возвращает один из следующих кодов состояния:

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

NDIS_STATUS_SUCCESS

Запрос успешно завершен. InformationBuffer указывает на структуру NDIS_NIC_SWITCH_CAPABILITIES.

NDIS_STATUS_NOT_SUPPORTED

Драйвер мини-порта либо не поддерживает интерфейс SR-IOV( с одним корневым интерфейсом виртуализации ввода-вывода), либо не поддерживает его использование.

NDIS_STATUS_INVALID_LENGTH

Длина информационного буфера меньше, чем sizeof(NDIS_NIC_SWITCH_CAPABILITIES). Драйвер мини-порта должен задать значение DATA. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

NDIS_STATUS_FAILURE

Сбой запроса по другим причинам.

Требования

Версия

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

Заголовок

 Ntddndis.h (включая Ndis.h)

См. также раздел

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST