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 (включая Ndis.h) |