OID_NIC_SWITCH_FREE_VF
Драйвер 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) |