OID_SRIOV_RESET_VF
Избыточные драйверы выдают запрос на набор идентификатора объекта (OID) OID_SRIOV_RESET_VF для сброса указанной виртуальной функции PCI Express (PCIe) на сетевом адаптере, который поддерживает виртуализацию ввода-вывода с одним корнем. Избыточные драйверы выдают этот запрос на набор OID драйверу мини-порта физической функции (PF) PCI Express (PCIe) сетевого адаптера.
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на NDIS_SRIOV_RESET_VF_PARAMETERS структуру. Драйвер overlying указывает идентификатор VF для сброса через член VFId этой структуры.
Комментарии
VF можно сбросить с помощью сброса уровня функций PCI Express (PCIe) (FLR). Так как запрос FLR является привилегированной операцией, его может выполнить только драйвер мини-порта PF, который выполняется в операционной системе управления родительского раздела Hyper-V. Неподдерживаемые драйверы, работающие в операционной системе управления, получают уведомление о запросе FLR и выдают запрос набора OID OID_SRIOV_RESET_VF драйверу мини-порта PF.
При обработке этого запроса OID драйвер мини-порта PF должен следовать следующим рекомендациям:
Драйвер мини-порта PF должен убедиться, что VF, указанный членом VFIdструктуры NDIS_SRIOV_RESET_VF_PARAMETERS , содержит ресурсы, которые были ранее выделены. Драйвер мини-порта PF выделяет ресурсы для VF во время запроса метода OID OID_NIC_SWITCH_ALLOCATE_VF. Если ресурсы для указанного виртуальногоf не выделены, драйвер должен завершить запрос OID.
Операция сброса должна влиять только на указанный VF. Операция не должна влиять на другие виртуальные машины или PF на том же сетевом адаптере.
Дополнительные сведения см. в разделе Сброс виртуальной функции.
Коды состояния возврата
Драйвер мини-порта PF возвращает один из следующих кодов состояния для запроса набора OID_SRIOV_RESET_VF.
| Код состояния | Описание |
|---|---|
NDIS_STATUS_SUCCESS |
Запрос OID успешно завершен. |
NDIS_STATUS_NOT_SUPPORTED |
Драйвер мини-порта PF либо не поддерживает интерфейс виртуализации однокорневого ввода-вывода (SR-IOV), либо не поддерживает его использование. |
NDIS_STATUS_INVALID_PARAMETER |
Один или несколько членов структуры NDIS_SRIOV_RESET_VF_PARAMETERS имеют недопустимые значения. |
NDIS_STATUS_INVALID_LENGTH |
Буфер сведений был слишком коротким. Драйвер мини-порта PF должен задать data. SET_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера. |
NDIS_STATUS_FAILURE |
Сбой запроса по другим причинам. |
Требования
Версия |
Поддерживается в NDIS 6.30 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |