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


OID_NIC_SWITCH_CURRENT_CAPABILITIES

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

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

Замечания

Начиная с версии NDIS 6.20, драйверы минипорта предоставляют аппаратные возможности коммутатора сетевых адаптеров в сетевом адаптере при вызове функции 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

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

NDIS_STATUS_FAILURE

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

Требования

Версия

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

Заголовок

Ntddndis.h (include Ndis.h)

См. также

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST