Поделиться через


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)

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


NDIS_OID_REQUEST

NDIS_SRIOV_SET_VF_POWER_STATE_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF