OID_NIC_SWITCH_ENUM_SWITCHES
Слишком избыточный драйвер или приложение в пользовательском режиме выдает запрос запроса идентификатора объекта (OID) OID_NIC_SWITCH_ENUM_SWITCHES для получения массива. Каждый элемент в массиве задает атрибуты коммутатора сетевого адаптера, созданного на сетевом адаптере.
После успешного возврата из этого запроса OID InformationBuffer член структуры NDIS_OID_REQUEST содержит указатель на буфер, содержащий следующее:
Структура NDIS_NIC_SWITCH_INFO_ARRAY, которая определяет количество элементов в массиве.
Массив структур NDIS_NIC_SWITCH_INFO. Каждая из этих структур содержит сведения об одном коммутаторе сетевого адаптера, созданном на сетевом адаптере.
Примечание Если сетевой адаптер не имеет коммутаторов сетевого адаптера, драйвер задает NumElements член структуры NDIS_NIC_SWITCH_INFO_ARRAY равным нулю, и не возвращаются NDIS_NIC_SWITCH_INFO структуры.
Замечания
Переопределяющие драйверы и приложения в пользовательском режиме выдают запросы OID OID_NIC_SWITCH_ENUM_SWITCHES для перечисления коммутаторов сетевого адаптера, созданных на сетевом адаптере.
Примечание начиная с Windows Server 2012, интерфейс виртуализации одно корневых операций ввода-вывода (SR-IOV) поддерживает только переключатель сетевого адаптера по умолчанию. Поэтому возвращаемая структура NDIS_NIC_SWITCH_INFO_ARRAY должна указывать один элемент NDIS_NIC_SWITCH_INFO для коммутатора сетевого адаптера по умолчанию, на который ссылается идентификатор NDIS_DEFAULT_SWITCH_ID.
Коды состояния возврата
NDIS обрабатывает запрос OID OID_NIC_SWITCH_ENUM_SWITCHES запроса для мини-портов. Драйверы не будут выданы этим запросом OID.
Когда NDIS обрабатывает запрос OID_NIC_SWITCH_ENUM_SWITCHES, он возвращает один из следующих кодов состояния.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
NDIS_STATUS_NOT_SUPPORTED |
Минипорт-драйвер либо не поддерживает интерфейс SR-IOV, либо не включен для использования интерфейса. |
NDIS_STATUS_INVALID_PARAMETER |
Один или несколько членов структуры NDIS_NIC_SWITCH_INFO_ARRAY имеют недопустимые значения. |
NDIS_STATUS_INVALID_LENGTH |
Буфер информации был слишком коротким. NDIS задает DATA. QUERY_INFORMATION. Элемент BytesNeeded в структуре NDIS_OID_REQUEST к минимальному размеру буфера, который требуется. |
NDIS_STATUS_FAILURE |
Запрос завершился ошибкой по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (include Ndis.h) |