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