OID_NIC_SWITCH_DELETE_VPORT

Статья
13.03.2025

Переопределяющий драйвер выдает запрос набора идентификатора объекта (OID) OID_NIC_SWITCH_DELETE_VPORT для удаления недефесультного виртуального порта (VPort), который ранее был создан на коммутаторе сетевого адаптера. Ранее созданный драйвер может удалить VPort, созданный только путем выдачи запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.

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

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

Замечания

Слишком большой драйвер, например протокол или драйвер фильтра, может удалять только созданный ранее неотделимый VPort. Драйвер чрезмерного использования создает VPort путем выдачи запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.

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

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

Примечание Только недефекционные виртуальные порты можно явно удалить с помощью запросов OID OID_NIC_SWITCH_DELETE_VPORT. Виртуальный порт по умолчанию неявно удаляется, когда драйвер мини-порта PF удаляет переключатель сетевого адаптера по умолчанию. Дополнительные сведения см. в удалениикоммутатора сетевого адаптера.

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

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

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