OID_NIC_SWITCH_DELETE_SWITCH

Статья
03/13/2025

NDIS выдает запрос набора идентификатора объекта (OID) OID_NIC_SWITCH_DELETE_SWITCH для удаления коммутатора сетевого адаптера из сетевого адаптера.

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

Примечание Переопределения драйверов, таких как драйверы протокола или фильтра, не могут выдавать этот запрос метода OID к драйверу мини-порта PF.

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

Замечания

Запрос набора OID OID_NIC_SWITCH_DELETE_SWITCH удаляет коммутатор сетевой карты, созданный ранее с помощью запроса метода OID OID_NIC_SWITCH_CREATE_SWITCH.

При получении запроса метода OID OID_NIC_SWITCH_DELETE_SWITCH драйвер минипорта PF должен выполнить следующие действия:

Если драйвер минипорта PF поддерживает статическое создание и настройку коммутаторов сетевого адаптера, он должен освободить ресурсы программного обеспечения, связанные с указанным коммутатором сетевого адаптера. Однако драйвер может освободить аппаратные ресурсы для коммутатора сетевого адаптера, если вызывается MiniportHaltEx.

Дополнительные сведения о создании статического коммутатора сетевого адаптера см. в статического создания коммутатора сетевого адаптера.
Если драйвер мини-порта PF поддерживает динамическое создание и настройку коммутаторов сетевого адаптера, он должен освободить аппаратные и программные ресурсы, связанные с указанным коммутатором сетевого адаптера.

Дополнительные сведения о создании динамического коммутатора сетевого адаптера см. в разделе динамическое создание коммутатора сетевого адаптера.
Если драйвер мини-порта PF поддерживает динамическое создание и все коммутаторы сетевого адаптера были удалены, драйвер должен отключить виртуализацию на адаптере, вызвав NdisMEnableVirtualization. Чтобы отключить виртуализацию, сетевой адаптер должен задать для параметра EnableVirtualization значение FALSE, а параметр NumVFs равно нулю.

NdisMEnableVirtualization очищает элемент NumVFs и VF Enable бит в структуре расширенных возможностей SR-IOV в пространстве конфигурации PCI сетевого адаптера.

Примечание Если драйвер минипорта PF поддерживает статическое создание и настройку коммутаторов сетевого адаптера, он должен вызывать только NdisMEnableVirtualization при вызове MiniportHaltEx.

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

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

Функция miniport driver MiniportOidRequest возвращает одно из следующих значений для этого запроса:

Срок	Описание
NDIS_STATUS_SUCCESS	Минипорт-драйвер успешно завершил запрос.
NDIS_STATUS_PENDING	Минипорт-драйвер завершит запрос асинхронно. После завершения всей обработки минипорт-драйвера запрос должен завершиться путем вызова функции NdisMOidRequestComplete, передав NDIS_STATUS_SUCCESS для параметра состояния.
NDIS_STATUS_NOT_ACCEPTED	Драйвер минипорта сбрасывается.
NDIS_STATUS_REQUEST_ABORTED	Минипорт-драйвер перестал обрабатывать запрос. Например, NDIS называется функцией MiniportResetEx.

NDIS возвращает один из следующих кодов состояния для этого запроса:

Срок	Описание
NDIS_STATUS_SUCCESS	Запрос OID успешно завершен.
NDIS_STATUS_NOT_SUPPORTED	Драйвер мини-порта PF либо не поддерживает интерфейс SR-IOV, либо не включен для использования интерфейса.
NDIS_STATUS_FILE_NOT_FOUND	Одно или несколько элементов структуры NDIS_NIC_SWITCH_DELETE_SWITCH_PARAMETERS имеют недопустимые значения.
NDIS_STATUS_INVALID_LENGTH	Буфер информации слишком мал. NDIS задает DATA. SET_INFORMATION. Элемент BytesNeeded в структуре NDIS_OID_REQUEST к минимальному размеру буфера, который требуется.