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

当系统处于 S0 时，设备需要用于 D3cold 的瓦数（以 mW 为单位）。 此值必须小于 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 (包括 Wdm.h)