PO_FX_DEVICE_POWER_REQUIRED_CALLBACK wdm.h (回调函数)

DevicePowerRequiredCallback 回调例程通知设备驱动程序设备必须进入并保持 D0 电源状态。

语法

PO_FX_DEVICE_POWER_REQUIRED_CALLBACK PoFxDevicePowerRequiredCallback;

void PoFxDevicePowerRequiredCallback(
  [in] PVOID Context
)
{...}

参数

[in] Context

指向设备上下文的指针。 设备驱动程序使用此上下文来存储有关设备当前电源状态的信息。 设备驱动程序在 PO_FX_DEVICE 结构的 DeviceContext 成员中指定了此指针,驱动程序用于向 PoFx (电源管理框架注册) 。 此上下文对 PoFx 是不透明的。

返回值

备注

PoFx 调用驱动程序的 DevicePowerRequiredCallback 例程后,如果设备尚未进入 D0 状态,则驱动程序必须通过向设备堆栈向下发送 D0 IRP (IRP_MN_SET_POWER) 请求来启动到 D0 状态转换。 在驱动程序完成 (所有较低驱动程序完成) 处理此请求后,驱动程序必须调用 PoFxReportDevicePoweredOn 例程。 PoFxReportDevicePoweredOn 调用通知 PoFx 设备已完成对 DevicePowerRequiredCallback 调用的响应。 驱动程序可以在 DevicePowerRequiredCallback 调用期间或之后调用 PoFxReportDevicePoweredOn

每次调用 DevicePowerRequiredCallback 例程时,驱动程序必须通过调用 PoFxReportDevicePoweredOn 进行响应PoFxReportDevicePoweredOn 调用可以在 DevicePowerRequiredCallback 调用期间或之后发生。 无论不需要 D0 IRP、D0 IRP 请求失败,还是调度的 D0 IRP 成功或失败,驱动程序都必须调用 PoFxReportDevicePoweredOn

PoFx 仅在 PoFx 之前调用驱动程序的 DevicePowerNotRequiredCallback 例程来通知驱动程序设备不需要保持 D0 状态时,才调用 DevicePowerRequiredCallback 例程。

在驱动程序调用 PoFxCompleteDevicePowerNotRequired 以完成 DevicePowerNotRequiredCallback 回调后,随时都可以调用 DevicePowerRequiredCallback 例程。 DevicePowerRequiredCallback 调用不一定是由于驱动程序采取的操作(例如请求组件更改为活动条件)而发生的。

示例

若要定义 DevicePowerRequiredCallback 回调例程,必须先提供一个函数声明,用于标识要定义的回调例程的类型。 Windows为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于驱动程序的 Code Analysis、静态驱动程序验证程序 ( SDV) 和其他验证工具查找错误,并且需要为 Windows 操作系统编写驱动程序。

例如,若要定义名为 的 DevicePowerRequiredCallback MyDevicePowerRequiredCallback回调例程,请使用 PO_FX_DEVICE_POWER_REQUIRED_CALLBACK 类型,如以下代码示例所示:

PO_FX_DEVICE_POWER_REQUIRED_CALLBACK MyDevicePowerRequiredCallback;

然后,按如下所示实现回调例程:

_Use_decl_annotations_
VOID
  MyDevicePowerRequiredCallback(
    PVOID Context
    )
  {
      // Function body
  }

此PO_FX_DEVICE_POWER_REQUIRED_CALLBACK类型是在 Wdm.h 头文件中定义的。 若要在运行代码分析工具时更准确地识别错误,请确保将 Use_decl_annotations注释添加到 函数定义。 Use_decl_annotations注释 可确保使用应用于头文件中PO_FX_DEVICE_POWER_REQUIRED_CALLBACK函数类型的批注。 有关函数声明的要求详细信息,请参阅 使用 WDM 驱动程序的函数角色类型声明函数。 有关 函数Use_decl_annotations,请参阅批注函数行为

要求

   
最低受支持的客户端 支持从 Windows 8 开始。
目标平台 桌面型
标头 wdm.h (包括 Wudfwdm.h)
IRQL 在 IRQL 调用<= DISPATCH_LEVEL。

请参阅

DevicePowerNotRequiredCallback

PO_FX_DEVICE

PoFxCompleteDevicePowerNotRequired

PoFxRegisterDevice

PoFxReportDevicePoweredOn