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)

См. также раздел


NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH