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


OID_NIC_SWITCH_ALLOCATE_VF

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

Чрезмерное выполнение драйверов выдает этот запрос метода OID к мини-драйверу для физической функции PCIe сетевого адаптера (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 этот драйвер является единственным компонентом, который может запросить освобождение ресурсов для того же 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) или не включен для использования интерфейса.

NDIS_STATUS_INVALID_PARAMETER

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

NDIS_STATUS_INVALID_LENGTH

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

NDIS_STATUS_FAILURE

Запрос завершился ошибкой по другим причинам.

Требования

Версия

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

Заголовок

Ntddndis.h (include 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