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) |