OID_NIC_SWITCH_FREE_VF

Статья
06/15/2023

Драйвер overlying выдает запрос на набор идентификатора объекта (OID) OID_NIC_SWITCH_FREE_VF, чтобы освободить ресурсы для виртуальной функции (VF) PCI Express (PCIe) сетевого адаптера.

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

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

Драйвер overlying указывает идентификатор виртуальной машины, освобождаемой через член VFId этой структуры. Драйвер получил этот идентификатор из предыдущего запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF.

Избыточный драйвер выдает запрос на набор OID OID_NIC_SWITCH_FREE_VF, чтобы освободить ресурсы для виртуальной машины. Эти ресурсы ранее были выделены с помощью запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF.

Дополнительные сведения о том, как освободить ресурсы VF, см. в разделе Освобождение ресурсов для виртуальной функции.

Примечание Когда избыточный драйвер запрашивает выделение ресурсов для виртуальной машины, этот драйвер является единственным компонентом, который может запросить освобождение ресурсов для той же виртуальной машины. Для освобождения ресурсов VF драйвер должен выдать запрос на набор OID OID_NIC_SWITCH_FREE_VF. Прежде чем можно будет остановить драйвер, он должен освободить ресурсы для каждой виртуальной машины, выделенной запросом OID_NIC_SWITCH_ALLOCATE_VF драйвера.

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

Функция 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_FREE_VF_PARAMETERS имеют недопустимые значения. Например, член VFId может указать VF, который либо не был выделен, либо имеет неудаляемые виртуальные порты.
NDIS_STATUS_INVALID_LENGTH	Информационный буфер слишком мал. NDIS задает значение DATA. SET_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

Требования

Версия	Поддерживается в NDIS 6.30 и более поздних версиях.
Заголовок	Ntddndis.h (включая Ndis.h)