Поделиться через


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-файла или на странице свойств advanced .

Примечание Все возможности указанного коммутатора сетевого адаптера возвращаются с помощью запроса 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) или не поддерживает использование интерфейса.

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_FAILURE

Запрос завершился ошибкой по другим причинам.

Требования

Версия

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

Заголовок

Ntddndis.h (include Ndis.h)

См. также

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST