OID_NIC_SWITCH_PARAMETERS
Переопределяющий драйвер выдает запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_PARAMETERS для получения текущих параметров конфигурации указанного коммутатора сетевого адаптера. NDIS обрабатывает эти запросы метода OID для мини-порта драйвера.
Переопределяющие драйверы выдают запрос набора OID OID_NIC_SWITCH_PARAMETERS для задания параметров конфигурации указанного сетевого коммутатора на сетевом адаптере. Эти запросы набора OID выдаются мини-драйверу физической функции PCI Express (PCIe) сетевого адаптера .PF. Эти запросы набора OID требуются для драйверов минипорта PF, поддерживающих интерфейс виртуализации единого корневого ввода-вывода (SR-IOV).
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_NIC_SWITCH_PARAMETERS.
Драйвер переопределения задает переключатель сетевого адаптера для метода OID или запроса, задав SwitchId элемент структуры NDIS_NIC_SWITCH_PARAMETERS идентификатору коммутатора. Драйвер переопределения получает идентификатор коммутатора одним из следующих способов:
Из предыдущего запроса метода OID OID_NIC_SWITCH_ENUM_SWITCHES.
Из NicSwitchArray член структуры NDIS_BIND_PARAMETERS. NDIS передает указатель на эту структуру в параметре bindParameters 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.
Переопределяющий драйвер выдает запрос набора 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 (include Ndis.h) |