OID_NIC_SWITCH_DELETE_SWITCH
NDIS выдает запрос на набор идентификатора объекта (OID) OID_NIC_SWITCH_DELETE_SWITCH для удаления коммутатора сетевого адаптера из сетевого адаптера.
NDIS отправляет этот запрос на набор OID драйверу мини-порта физической функции (PF) сетевого адаптера PCI Express (PCIe). Этот запрос на набор 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.
Примечание Если драйвер минипорта PF поддерживает статическое создание и настройку коммутаторов сетевого адаптера, он должен вызывать NdisMEnableVirtualization только при вызове MiniportHaltEx .
Дополнительные сведения см. в разделе Удаление коммутатора сетевого адаптера.
Коды состояния возврата
Функция MiniportOidRequest драйвера miniport возвращает одно из следующих значений для этого запроса:
| Термин | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Драйвер мини-порта успешно выполнил запрос. |
NDIS_STATUS_PENDING |
Драйвер мини-порта выполнит запрос асинхронно. После того как драйвер мини-порта завершит всю обработку, он должен выполнить запрос, вызвав функцию NdisMOidRequestComplete , передав NDIS_STATUS_SUCCESS для параметра Status . |
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 структуру до минимального требуемого размера буфера. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |