OID_NIC_SWITCH_CREATE_VPORT

Статья
06/15/2023

Избыточный драйвер отправляет запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_CREATE_VPORT для создания виртуального порта без изменений (VPort) на сетевом коммутаторе сетевого адаптера. Этот запрос метода OID также подключает созданный VPort к физической функции (PF) pci Express (PCIe) сетевого адаптера или ранее выделенной виртуальной функции PCIe (VF).

Избыточные драйверы выдают этот запрос метода OID к драйверу минипорта для PF сетевого адаптера. Этот запрос метода OID требуется для драйверов минипорта PF, которые поддерживают интерфейс одно корневой виртуализации ввода-вывода (SR-IOV).

Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_NIC_SWITCH_VPORT_PARAMETERS .

Драйвер overlying инициализирует структуру NDIS_NIC_SWITCH_VPORT_PARAMETERS со сведениями о конфигурации создаваемого неdefault VPort. Сведения о конфигурации включают функцию PCIe, к которой подключен неdefault VPort, и количество пар очередей для неdefault VPort.

Когда драйверу минипорта PF отправляется запрос OID, драйвер выделяет аппаратные и программные ресурсы, связанные с указанным неразрешимый VPort. После успешного выделения всех ресурсов драйвер минипорта PF успешно завершает OID, возвращая NDIS_STATUS_SUCCESS из MiniportOidRequest.

Если запрос OID_NIC_SWITCH_CREATE_VPORT завершается успешно, драйвер мини-порта PF и вышерасполагающий драйвер должны сохранить значение VPortId неdefault VPort для последовательных операций. Значение VPortId используется во время следующих операций:

NDIS и избыточные драйверы используют значение VPortId для идентификации неразрешенный VPort в последовательных запросах OID, связанных с этим VPort, таких как OID_NIC_SWITCH_VPORT_PARAMETERS и OID_NIC_SWITCH_DELETE_VPORT.
Во время операций отправки NDIS задает значение VPortId для идентификации VPort, из которого был отправлен пакет. Это значение указывается в NDIS_NET_BUFFER_LIST_FILTERING_INFO данныхNET_BUFFER_LIST структуры.
Во время операций получения драйвер мини-порта PF задает значение VPortId , в которое должен быть переадресован пакет. Это значение также указывается в данных OOB NDIS_NET_BUFFER_LIST_FILTERING_INFO структуры NET_BUFFER_LIST .

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

Примечание VPort по умолчанию всегда существует и не создается, хотя запрос OID OID_NIC_SWITCH_CREATE_VPORT. VPort по умолчанию имеет идентификатор NDIS_DEFAULT_VPORT_ID. Когда драйвер минипорта PF создает коммутатор сетевого адаптера, драйвер автоматически подключает VPort по умолчанию к PF сетевого адаптера.

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

NDIS или драйвер минипорта PF возвращает один из следующих кодов состояния для запроса метода OID OID_NIC_SWITCH_CREATE_SWITCH.

Код состояния	Описание
NDIS_STATUS_SUCCESS	Запрос OID успешно завершен.
NDIS_STATUS_NOT_SUPPORTED	Драйвер минипорта PF либо не поддерживает интерфейс SR-IOV, либо не поддерживает интерфейс .
NDIS_STATUS_INVALID_PARAMETER	Один или несколько членов структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS имеют недопустимые значения.
NDIS_STATUS_INVALID_LENGTH	Длина информационного буфера меньше, чем sizeof(NDIS_NIC_SWITCH_VPORT_PARAMETERS). Драйвер минипорта PF должен задать data. METHOD_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.
NDIS_STATUS_FAILURE	Сбой запроса по другим причинам.

Требования

Версия	Поддерживается в NDIS 6.30 и более поздних версиях.
Заголовок	Ntddndis.h (включая Ndis.h)