OID_NIC_SWITCH_VF_PARAMETERS

Статья
03/13/2025

Неуклюжий драйвер или приложение пользовательского режима выдает запрос метода идентификатора объекта (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 для драйверов мини-порта и возвращает следующий код состояния для запросов метода 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	Длина буфера информации меньше размера (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	Запрос завершился ошибкой по другим причинам.