通过

PO_FX_POWER_CONTROL_CALLBACK回调函数 （wdm.h）

  • 项目

PowerControlCallback 回调例程执行电源管理框架（PoFx）请求的电源控制作。

语法

PO_FX_POWER_CONTROL_CALLBACK PoFxPowerControlCallback;

NTSTATUS PoFxPowerControlCallback(
                  PVOID DeviceContext,
  [in]            LPCGUID PowerControlCode,
  [in, optional]  PVOID InBuffer,
  [in]            SIZE_T InBufferSize,
  [out, optional] PVOID OutBuffer,
  [in]            SIZE_T OutBufferSize,
  [out, optional] PSIZE_T BytesReturned
)
{...}

参数

DeviceContext

[in] PowerControlCode

指向电源控件代码的指针。 此代码是指定所请求作的 GUID 值。

[in, optional] InBuffer

指向包含作输入数据的缓冲区的指针。 此缓冲区中的数据格式取决于由 PowerControlCode 参数指定的电源控制代码。 InBuffer 参数是可选的，如果指定的作不需要输入数据，则可以指定为 NULL。

[in] InBufferSize

InBuffer 参数指向的输入缓冲区的大小（以字节为单位）。 如果 InBuffer 为 NULL，则此参数为零。

[out, optional] OutBuffer

指向回调例程从作写入输出数据的缓冲区的指针。 此缓冲区中的数据格式取决于由 PowerControlCode 参数指定的电源控制代码。 OutBuffer 参数是可选的，如果指定的作不生成输出数据，则可以指定为 NULL。

[in] OutBufferSize

OutBuffer 参数指向的输出缓冲区的大小（以字节为单位）。 如果 OutBuffer 为 NULL，则此参数为零。

[out, optional] BytesReturned

指向一个位置的指针，例程将写入到 OutBuffer指向的缓冲区的数据字节数。 写入的字节数必须小于或等于 OutBufferSize。 此参数是可选的，如果调用方不需要知道写入到输出缓冲区的字节数，则可以指定为 NULL。

返回值

如果调用成功，PowerControlCallback 例程将返回STATUS_SUCCESS。 否则，它将返回适当的错误代码。

言论

PoFx 调用此例程，将电源控制请求直接发送到设备驱动程序。 电源控制请求类似于 I/O 控制请求（IOCTL）。 但是，与 IOCTL 不同，电源控制请求将直接发送到驱动程序，并且设备堆栈中的其他设备驱动程序不会观察到该请求。 在 PowerControlCallback 调用期间，驱动程序同步执行请求的作。

此例程是可选的。 实现 PowerControlCallback 例程不需要不支持电源控制作的设备驱动程序。

设备驱动程序可以调用 PoFxPowerControl 例程向 PoFx 发送电源控制请求。

有关电源控制请求的详细信息，请参阅 PoFxPowerControl。

例子

若要定义 PowerControlCallback 回调例程，必须先提供一个函数声明来标识要定义的回调例程的类型。 Windows 为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。

例如，若要定义名为 MyPowerControlCallback的 PowerControlCallback 回调例程，请使用PO_FX_POWER_CONTROL_CALLBACK类型，如以下代码示例所示：

PO_FX_POWER_CONTROL_CALLBACK MyPowerControlCallback;

然后，按如下所示实现回调例程：

_Use_decl_annotations_
NTSTATUS
  MyPowerControlCallback(
    PVOID Context,
    LPCGUID PowerControlCode,
    PVOID InBuffer,
    SIZE_T InBufferSize,
    PVOID OutBuffer,
    SIZE_T OutBufferSize,
    PSIZE_T BytesReturned
    )
  {
      // Function body
  }

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

要求

要求 价值
最低支持的客户端 从 Windows 8 开始支持。
目标平台 桌面
标头 wdm.h （包括 Wudfwdm.h）
IRQL 在 IRQL <调用 = DISPATCH_LEVEL。

另请参阅

PO_FX_DEVICE

PoFxPowerControl