функция обратного вызова D3COLD_REQUEST_AUX_POWER (wdm.h)

  • Статья

Позволяет объекту функционального устройства (FDO) передать его вспомогательные требования к энергопотреблению.

Синтаксис

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

NTSTATUS D3coldRequestAuxPower(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG AuxPowerInMilliWatts,
  [_Out_]                                     PULONG RetryInSeconds
)
{...}

Параметры

Context

Дескриптор устройства.

[_In_] AuxPowerInMilliWatts

Мощность в единицах мВт, необходимая устройству для D3cold, когда система находится в S0. Это значение должно быть меньше 0x80000000.

[_Out_] RetryInSeconds

Указатель на переменную ULONG, которая получает количество секунд, в течение которых драйвер может повторить запрос при сбое запроса с STATUS_RETRY.

Возвращаемое значение

Если операция выполнена успешно, возвращается STATUS_SUCCESS. В противном случае возвращается соответствующий код ошибки ЗНАЧЕНИЯ NTSTATUS. Дополнительные сведения см. в разделе Значения NTSTATUS. Возможны следующие ошибки:

Код ошибки Описание
STATUS_INVALID_PARAMETER Недопустимый входной параметр.
STATUS_INVALID_DEVICE_REQUEST Устройство не находится в D0 или не является инициатором запроса не функция 0.
STATUS_RETRY Запрос завершился сбоем, и система указывает, что можно повторить попытку. RetryInSeconds будет содержать количество секунд, в течение которых драйвер должен ожидать перед выполнением следующего запроса.
STATUS_UNSUCCESSFUL Запрос завершился сбоем, и система указывает, что текущее запрошенное значение невозможно.
STATUS_SUCCESS Запрос выполнен успешно.

Комментарии

Драйвер устройства, который успешно запрашивает интерфейс GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE, получает указатель на D3COLD_AUX_POWER_AND_TIMING_INTERFACE структуру, в которой драйвер задает члену RequestAuxPower указатель на его реализацию функции обратного вызова D3COLD_REQUEST_AUX_POWER .

  • Для многофункционального устройства только функция 0 будет вызывать эту подпрограмму и задавать вспомогательное питание для всего устройства.

  • Функция 0 должна находиться в состоянии D0 при вызове этой подпрограммы.

  • После успешного выполнения этого запроса нет никакой гарантии, что основное питание power rail будет удалено.

Требования

Требование Значение
Минимальная версия клиента Windows 10 версии 1803
Верхняя часть wdm.h (включая Wdm.h)