OID_NIC_SWITCH_PARAMETERS
Избыточный драйвер выдает запрос метода идентификатора объекта (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_NIC_SWITCH_PARAMETERS запросов следующим образом:
Для получения текущих параметров указанного коммутатора сетевого адаптера драйвер выполняет запрос метода 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) |