OID_NIC_SWITCH_VPORT_PARAMETERS

Переопределяющий драйвер может получить параметры виртуального порта (VPort) на коммутаторе сетевого адаптера, который был создан на сетевом адаптере, поддерживающем виртуализацию одно корневых операций ввода-вывода (SR-IOV). Драйвер выдает запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_VPORT_PARAMETERS для получения этих параметров.

Переопределяющие драйверы выдают запрос набора OID OID_NIC_SWITCH_VPORT_PARAMETERS для задания параметров конфигурации указанного виртуального порта, подключенного к сетевому коммутатору сетевого адаптера. Эти запросы набора OID выдаются мини-драйверу физической функции PCI Express (PCIe) сетевого адаптера .PF. Эти запросы набора OID требуются для драйверов минипорта PF, поддерживающих интерфейс виртуализации единого корневого ввода-вывода (SR-IOV).

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

Драйвер переопределения задает VPort для метода OID или запроса, задав VPortId член структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS идентификатор, связанный с VPort. Драйвер с превышением получает идентификатор 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 для изменения текущих параметров конфигурации виртуального порта, подключенного к сетевому коммутатору сетевого адаптера. Этот запрос OID можно использовать для обновления параметров по умолчанию, а также неотделательных виртуальных портов.

Можно изменить только ограниченное подмножество параметров конфигурации для VPort. Переопределяющий драйвер указывает параметр для изменения, задав следующие члены структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS:

1. Элемент VPortId имеет идентификатор VPort, параметры которого будут изменены.

2. Соответствующие флаги NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED задаются в элементе Flags. Элементы структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS можно изменить только в том случае, если в ntddndis.h определен соответствующий флаг NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED.

3. Соответствующие элементы структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS задаются с параметрами конфигурации VPort, которые необходимо изменить.

Когда драйвер мини-порта PF получает запрос набора OID OID_NIC_SWITCH_VPORT_PARAMETERS, драйвер настраивает оборудование с параметрами конфигурации. Драйвер может изменять только эти параметры конфигурации, определяемые флагами NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED в элементе флагов структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS.

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

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

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

Требования

См. также

NDIS_NIC_SWITCH_VPORT_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_VPORTS