OID_NIC_SWITCH_ENUM_VFS

  • Статья

Драйвер или приложение пользовательского режима выдает запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_ENUM_VFS для получения массива. Каждый элемент в массиве задает атрибуты виртуальной функции PCI Express (PCIe), подключенной к коммутатору сетевого адаптера.

После успешного возврата из этого запроса OID член InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на буфер, содержащий следующее:

  • Структура NDIS_NIC_SWITCH_VF_INFO_ARRAY , определяющая количество элементов в массиве.

  • Массив NDIS_NIC_SWITCH_VF_INFO структур. Каждая из этих структур содержит сведения об одном виртуальномF на сетевом коммутаторе сетевого адаптера. VF присоединяется к коммутатору сетевого адаптера с помощью запросов метода OID OID_NIC_SWITCH_ALLOCATE_VF.

    Примечание Если виртуальные машины не подключены к коммутатору сетевого адаптера на сетевом адаптере, элемент NumElementsструктуры NDIS_NIC_SWITCH_VF_INFO_ARRAY устанавливается в нулевое значение и NDIS_NIC_SWITCH_VF_INFO структуры не возвращаются.

Комментарии

Избыточные драйверы и приложения пользовательского режима выдают запросы метода OID OID_NIC_SWITCH_ENUM_VFS для перечисления виртуальных функций, подключенных к коммутатору сетевого адаптера.

Прежде чем драйвер или приложение выдает запрос OID, он должен инициализировать структуру NDIS_NIC_SWITCH_VF_INFO_ARRAY , которая передается вместе с запросом. Драйвер или приложение должны следовать этим рекомендациям при инициализации структуры NDIS_NIC_SWITCH_VF_INFO_ARRAY :

  • Если флаг NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH установлен в элементе Flags , драйвер или приложение должны задать для элемента SwitchId идентификатор коммутатора сетевого адаптера на сетевом адаптере SR-IOV. Если задать эти члены таким образом, сведения VF возвращаются только для указанного коммутатора сетевой карты на сетевом адаптере SR-IOV.

    Примечание Драйвер и приложение пользовательского режима могут получить идентификаторы коммутатора сетевой карты, отправив запрос OID OID_NIC_SWITCH_ENUM_SWITCHES.

  • Если элемент Flags равен нулю, драйвер или приложение должны задать для элемента SwitchId значение 0. Если задать эти члены таким образом, данные VF возвращаются для всех коммутаторов сетевого адаптера SR-IOV.

Примечание Начиная с Windows Server 2012, Windows поддерживает только коммутатор сетевой карты по умолчанию на сетевом адаптере. Независимо от флагов, заданных в элементе Flags , параметру SwitchId необходимо задать значение NDIS_DEFAULT_SWITCH_ID.

Дополнительные сведения о коммутаторах сетевого адаптера см. в разделе Коммутаторы сетевого адаптера.

Коды состояния возврата

NDIS обрабатывает запрос метода OID OID_NIC_SWITCH_ENUM_VFS для драйверов мини-порта. Драйверы не будут выданы этот запрос OID.

Когда NDIS обрабатывает запрос OID_NIC_SWITCH_ENUM_VFS, он возвращает один из следующих кодов состояния.

Код состояния Описание

NDIS_STATUS_SUCCESS

Запрос OID успешно завершен.

NDIS_STATUS_NOT_SUPPORTED

Драйвер мини-порта либо не поддерживает интерфейс SR-IOV, либо не поддерживает интерфейс sr-IOV.

NDIS_STATUS_INVALID_PARAMETER

Один или несколько членов структуры NDIS_NIC_SWITCH_VF_INFO_ARRAY имеют недопустимые значения.

NDIS_STATUS_INVALID_LENGTH

Буфер сведений был слишком коротким. NDIS задает DATA. METHOD_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

NDIS_STATUS_FAILURE

Сбой запроса по другим причинам.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

 Ntddndis.h (включая Ndis.h)

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

NDIS_NIC_SWITCH_VF_INFO

NDIS_NIC_SWITCH_VF_INFO_ARRAY

NDIS_OID_REQUEST

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_VF_PARAMETERS