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

Статья
02/07/2025

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

Синтаксис

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

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

Параметры

Context

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

[_In_] AuxPowerInMilliWatts

Мощность в единицах mW, необходимых устройству для 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 при вызове этой подпрограммы.
Нет никакой гарантии, что основная электростанция будет удалена после успешного выполнения этого запроса.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1803
заголовка	wdm.h (include Wdm.h)

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