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) |