OID_NIC_SWITCH_DELETE_VPORT
Избыточный драйвер выдает запрос на набор идентификатора объекта (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 .
Комментарии
Избыточный драйвер, например драйвер протокола или фильтра, может удалить только ранее созданный неdefault VPort. Драйвер overlying создает VPort путем выполнения запроса метода OID OID_NIC_SWITCH_CREATE_VPORT.
Когда драйвер мини-порта PF получает запрос OID OID_NIC_SWITCH_DELETE_VPORT, драйвер должен освободить аппаратные и программные ресурсы, выделенные для указанного VPort.
Дополнительные сведения см. в разделе Удаление виртуального порта.
Примечание С помощью запросов OID OID_NIC_SWITCH_DELETE_VPORT можно явно удалить только неразделимые виртуальные порты. 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 |
Длина буфера сведений меньше, чем sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS). Драйвер мини-порта PF должен задать data. SET_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера. |
NDIS_STATUS_FAILURE |
Сбой запроса по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |