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