OID_NIC_SWITCH_HARDWARE_CAPABILITIES

  • Статья

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

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

Комментарии

Структура NDIS_NIC_SWITCH_CAPABILITIES содержит сведения об аппаратных возможностях коммутатора сетевой карты на сетевом адаптере. Эти возможности могут включать аппаратные возможности, которые в настоящее время отключены в параметрах INF-файла или на странице Дополнительные свойства.

Примечание Все возможности указанного коммутатора сетевой карты возвращаются с помощью запроса OID OID_NIC_SWITCH_HARDWARE_CAPABILITIES независимо от того, включена или отключена возможность.

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

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

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

NDIS обрабатывает запрос OID OID_NIC_SWITCH_HARDWARE_CAPABILITIES запрос на драйверы мини-порта и возвращает один из следующих кодов состояния:

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

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_NOT_SUPPORTED

Драйвер мини-порта либо не поддерживает интерфейс SR-IOV, либо не поддерживает интерфейс sr-IOV.

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_FAILURE

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

Требования

Версия

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

Заголовок

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

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

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST