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)