通过

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）
库 Ks.lib

另请参阅

KStrContextDispatch