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