OID_NIC_SWITCH_VF_PARAMETERS

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

NDIS обрабатывает запрос метода OID OID_NIC_SWITCH_VF_PARAMETERS для драйверов минипорта.

При выполнении запроса метода OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_NIC_SWITCH_VF_PARAMETERS .

Комментарии

Переопределяющий драйвер или приложение пользовательского режима указывает VF для запроса, задав для элемента VFIdструктуры NDIS_NIC_SWITCH_VF_PARAMETERS идентификатор VF. Переопределяющий драйвер или приложение получает идентификатор VF одним из следующих способов:

• Путем выдачи запроса метода OID для OID_NIC_SWITCH_ENUM_VFS.

  Если этот запрос OID успешно выполнен, приложение с избыточным драйвером или приложением пользовательского режима получит список всех виртуальных файлов, выделенных на сетевом адаптере. Каждый элемент в списке представляет собой NDIS_NIC_SWITCH_VF_INFO структуру с идентификатором VF, заданным элементом VFId .

• Путем выдачи запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF.

  Если этот запрос OID успешно выполнен, вышедшей драйвер получает идентификатор только что созданного VF в элементе VFId возвращаемой структуры NDIS_NIC_SWITCH_VF_PARAMETERS .

  Примечание Таким способом идентификатор VF могут получить только выше движущиеся драйверы.

После успешного возврата из запроса метода OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_NIC_SWITCH_VF_PARAMETERS . Эта структура содержит параметры конфигурации для указанного VF.

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

NDIS обрабатывает запрос метода OID OID_NIC_SWITCH_VF_PARAMETERS для драйверов miniport и возвращает следующий код состояния для запросов метода OID OID_NIC_SWITCH_VF_PARAMETERS.

Код состояния	Описание
NDIS_STATUS_SUCCESS	Запрос успешно завершен. Элемент InformationBuffer указывает на структуру NDIS_NIC_SWITCH_VF_PARAMETERS .
NDIS_STATUS_NOT_SUPPORTED	Драйвер мини-порта либо не поддерживает интерфейс SR-IOV( с одним корневым интерфейсом виртуализации ввода-вывода), либо не поддерживает его использование.
NDIS_STATUS_INVALID_PARAMETER	Один или несколько членов структуры NDIS_NIC_SWITCH_VF_PARAMETERS имеют недопустимые значения.
NDIS_STATUS_INVALID_LENGTH	Длина информационного буфера меньше размера sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). NDIS задает значение DATA. METHOD_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.
NDIS_STATUS_INVALID_LENGTH	Буфер сведений был слишком коротким. NDIS задает значение DATA. METHOD_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.
NDIS_STATUS_FAILURE	Сбой запроса по другим причинам.

Требования

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

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

---

NDIS_NIC_SWITCH_VF_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_ENUM_VFS

NDIS_NIC_SWITCH_VF_INFO

OID_NIC_SWITCH_VF_PARAMETERS