KsSetPowerDispatch 函数 (ks.h)

  • 项目

设置驱动程序对象收到IRP_MJ_POWER IRP 时要调用 的 电源调度函数。 仅当调用 KsDefaultDispatchPower 以调度或完成电源 IRP 时，这才有效。

其效果是将此对象标头添加到具有要执行的电源调度例程的对象标头列表。 此列表的头由设备标头保留。 假定调用方之前已使用 KsAllocateDeviceHeader 在基础设备对象上分配设备标头。

语法

KSDDKAPI VOID KsSetPowerDispatch(
  [in]           KSOBJECT_HEADER       Header,
  [in, optional] PFNKSCONTEXT_DISPATCH PowerDispatch,
  [in, optional] PVOID                 PowerContext
);

参数

[in] Header

指向以前由 KsAllocateObjectHeader 分配的标头。

[in, optional] PowerDispatch

（可选）包含将调用的电源调度函数;如果要从所调用的函数列表中删除该函数，则为 NULL 。 此函数不得完成发送的电源 IRP。 此函数的返回值必须STATUS_SUCCESS。 如果目的只是为了操作此列表条目，则可以在执行此电源调度例程时调用 KsSetPowerDispatch。 操作其他列表条目可能会混淆当前枚举。

[in, optional] PowerContext

（可选）包含要传递给电源调度函数的上下文参数。

返回值

无

要求

要求 值
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib

另请参阅

KStrContextDispatch