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