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)

См. также раздел

NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_PARAMETERS