OID_NIC_SWITCH_VPORT_PARAMETERS
Избыточный драйвер может получить параметры для виртуального порта (VPort) на коммутаторе сетевого адаптера, созданном на сетевом адаптере, поддерживающем виртуализацию одно корневых операций ввода-вывода (SR-IOV). Драйвер отправляет запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_VPORT_PARAMETERS для получения этих параметров.
Избыточные драйверы выдают запрос на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS для задания параметров конфигурации указанного порта VPort, подключенного к коммутатору сетевого адаптера. Эти запросы набора OID выдаются драйверу мини-порта физической функции (PF) pci Express (PCIe) сетевого адаптера. Эти запросы на набор OID необходимы для драйверов мини-портов PF, которые поддерживают интерфейс sr-IOV.
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на NDIS_NIC_SWITCH_VPORT_PARAMETERS структуру.
Драйвер overlying указывает VPort для метода OID или запроса set, задавая член VPortId структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS идентификатор, связанный с VPort. Драйвер overlying получает идентификатор VPort одним из следующих способов:
Из предыдущего запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.
Из предыдущего запроса метода OID OID_NIC_SWITCH_ENUM_VPORTS.
Комментарии
OID_NIC_SWITCH_VPORT_PARAMETERS можно использовать как в запросах метода OID, так и в запросах на набор OID.
Обработка запросов метода OID для OID_NIC_SWITCH_VPORT_PARAMETERS
Избыточные драйверы выдают запрос метода OID OID_NIC_SWITCH_VPORT_PARAMETERS для запроса текущих параметров конфигурации VPort, подключенного к коммутатору сетевого адаптера. Переопределяющие драйверы указывают VPort для запроса, задав для элемента VPortId структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS идентификатор VPort.
NDIS обрабатывает запрос метода OID OID_NIC_SWITCH_VPORT_PARAMETERS для драйверов мини-порта. NDIS возвращает сведения, полученные из предыдущих запросов OID OID_NIC_SWITCH_CREATE_VPORT и OID_NIC_SWITCH_ENUM_VPORTS.
После успешного возврата из запроса метода OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на NDIS_NIC_SWITCH_VPORT_PARAMETERS структуру. Эта структура содержит параметры конфигурации для указанного коммутатора.
Дополнительные сведения см. в статье Запрос параметров виртуального порта.
Обработка запросов на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS
Избыточные драйверы выдают запрос на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS для изменения текущих параметров конфигурации VPort, подключенного к коммутатору сетевого адаптера. Этот запрос OID можно использовать для обновления параметров как для стандартных, так и для неразрешительных виртуальных портов.
Изменить можно только ограниченное подмножество параметров конфигурации для VPort. Драйвер overlying задает параметр, который необходимо изменить, задав следующие члены структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS :
ЧленУ VPortId присваивается идентификатор VPort, параметры которого будут изменены.
Соответствующие флаги NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED задаются в элементе Flags . Элементы структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS можно изменить, только если в ntddndis.h определен соответствующий флаг NDIS_NIC_SWITCH_PARAMETERS_Xxxx_CHANGED.
Соответствующие элементы структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS задаются с параметрами конфигурации VPort, которые необходимо изменить.
После того как драйвер мини-порта PF получит запрос на набор OID OID_NIC_SWITCH_VPORT_PARAMETERS, драйвер настраивает оборудование с параметрами конфигурации. Драйвер может изменять только те параметры конфигурации, которые определены флагами NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED в элементе Flags структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS .
Дополнительные сведения см. в разделе Настройка параметров виртуального порта.
Коды состояния возврата
NDIS или драйвер минипорта PF возвращает следующий код состояния для запросов OID набора или метода OID_NIC_SWITCH_VPORT_PARAMETERS.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос успешно выполнен. InformationBuffer указывает на структуру NDIS_NIC_SWITCH_CAPABILITIES. |
NDIS_STATUS_NOT_SUPPORTED |
Драйвер мини-порта PF либо не поддерживает интерфейс виртуализации однокорневого ввода-вывода (SR-IOV), либо не поддерживает его использование. |
NDIS_STATUS_INVALID_PARAMETER |
Один или несколько членов структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS имеют недопустимые значения. |
NDIS_STATUS_INVALID_LENGTH |
Буфер сведений был слишком коротким. NDIS или драйвер мини-порта PF задает data. METHOD_INFORMATION. Член BytesNeeded (для запросов метода OID) или DATA. SET_INFORMATION. Член BytesNeeded (для запросов на набор OID) в структуре NDIS_OID_REQUEST минимально необходимого размера буфера. |
NDIS_STATUS_FAILURE |
Сбой запроса по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |