OID_SRIOV_SET_VF_POWER_STATE
Переопределяющий драйвер выдает запрос набора идентификатора объекта (OID) OID_SRIOV_SET_VF_POWER_STATE для изменения состояния питания указанной виртуальной функции PCI Express (PCIe) на сетевом адаптере. Так как изменение состояния питания является привилегированной операцией, переопределяя драйверы выдает этот запрос OID набора для мини-драйвера физической функции PCIe (PF) на сетевом адаптере. Затем драйвер мини-порта 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 выделяет ресурсы для VF во время запроса метода 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) или не включен для использования интерфейса. |
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 (include Ndis.h) |