Поделиться через

OID_NIC_SWITCH_ALLOCATE_VF

  • Статья

Драйвер overlying выдает запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_ALLOCATE_VF для выделения ресурсов для виртуальной функции PCI Express (PCIe) (VF). Виртуальная машина предоставляется в сетевом адаптере, который поддерживает интерфейс sr-IOV( с одним корневым интерфейсом виртуализации ввода-вывода).

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

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

Комментарии

Драйвер минипорта PF выделяет программные ресурсы для VF, когда драйвер обрабатывает запрос метода идентификатора объекта (OID) OID_NIC_SWITCH_ALLOCATE_VF. Несмотря на то, что аппаратные ресурсы были выделены для VF, он считается нерабочим до тех пор, пока драйвер мини-порта PF не завершит OID_NIC_SWITCH_ALLOCATE_VF.

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

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

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

Драйвер минипорта PF возвращает один из следующих кодов состояния для запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF.

Код состояния Описание

NDIS_STATUS_SUCCESS

Запрос OID успешно завершен.

NDIS_STATUS_NOT_SUPPORTED

Драйвер минипорта PF либо не поддерживает интерфейс sr-IOV(SR-IOV), либо не поддерживает его использование.

NDIS_STATUS_INVALID_PARAMETER

Один или несколько членов структуры NDIS_NIC_SWITCH_VF_PARAMETERS имеют недопустимые значения.

NDIS_STATUS_INVALID_LENGTH

Длина информационного буфера меньше размера sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). Драйвер минипорта PF должен задать data. METHOD_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

NDIS_STATUS_FAILURE

Сбой запроса по другим причинам.

Требования

Версия

Поддерживается в NDIS 6.30 и более поздних версиях.

Заголовок

 Ntddndis.h (включая Ndis.h)

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

NDIS_MAKE_RID

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_CREATE_VPORT

NDIS_NIC_SWITCH_VF_PARAMETERS

OID_NIC_SWITCH_FREE_VF