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