OID_NIC_SWITCH_PARAMETERS

Статья
06/15/2023

Избыточный драйвер выдает запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_PARAMETERS для получения текущих параметров конфигурации указанного коммутатора сетевой карты на сетевом адаптере. NDIS обрабатывает эти запросы метода OID для драйвера мини-порта.

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

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

Драйвер overlying указывает коммутатор сетевой карты для метода OID или запроса set, задавая член SwitchId структуры NDIS_NIC_SWITCH_PARAMETERS идентификатор коммутатора. Драйвер overlying получает идентификатор коммутатора одним из следующих способов:

Из предыдущего запроса метода OID OID_NIC_SWITCH_ENUM_SWITCHES.
Из элемента NicSwitchArrayструктуры NDIS_BIND_PARAMETERS . NDIS передает указатель на эту структуру в параметре BindParameters функции ProtocolBindAdapterEx .
Из элемента NicSwitchArrayструктуры NDIS_FILTER_ATTACH_PARAMETERS . NDIS передает указатель на эту структуру в параметре AttachParameters функции FilterAttach .

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

Для получения текущих параметров указанного коммутатора сетевого адаптера драйвер выполняет запрос метода OID OID_NIC_SWITCH_PARAMETERS. Дополнительные сведения см. в статье Запрос параметров коммутатора сетевого адаптера.

Примечание NDIS обрабатывает запросы метода OID OID_NIC_SWITCH_PARAMETERS для драйвера минипорта PF.
Драйвер overlying выдает запрос набора OID OID_NIC_SWITCH_PARAMETERS для изменения текущих параметров указанного коммутатора сетевого адаптера. Дополнительные сведения см. в разделе Настройка параметров коммутатора сетевого адаптера.

Примечание Драйвер мини-порта PF обрабатывает запросы на набор OID OID_NIC_SWITCH_PARAMETERS.

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

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

Код состояния	Описание
NDIS_STATUS_SUCCESS	Запрос успешно выполнен. InformationBuffer указывает на структуру NDIS_NIC_SWITCH_CAPABILITIES.
NDIS_STATUS_NOT_SUPPORTED	Драйвер мини-порта PF либо не поддерживает интерфейс виртуализации однокорневого ввода-вывода (SR-IOV), либо не поддерживает его использование.
NDIS_STATUS_INVALID_PARAMETER	Один или несколько членов структуры NDIS_NIC_SWITCH_PARAMETERS имеют недопустимые значения.
NDIS_STATUS_INVALID_LENGTH	Буфер сведений был слишком коротким. NDIS или драйвер мини-порта PF задает data. METHOD_INFORMATION. Член BytesNeeded (для запросов метода OID) или DATA. SET_INFORMATION. Член BytesNeeded (для запросов на набор OID) в структуре NDIS_OID_REQUEST минимально необходимого размера буфера.
NDIS_STATUS_REINIT_REQUIRED	Драйвер мини-порта PF требует повторной инициализации сетевого адаптера, чтобы применить изменения к коммутатору сетевого адаптера.
NDIS_STATUS_FAILURE	Сбой запроса по другим причинам.

Требования

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