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) |