UcmUcsiPpmStart 函数 (Ucmucsippm.h)

  • 项目

指示 UcmUcsiCx 类扩展开始向客户端驱动程序发送请求。

语法

NTSTATUS UcmUcsiPpmStart(
  [in] UCMUCSIPPM PpmObject
);

参数

[in] PpmObject

平台策略管理器的句柄 (PPM) 对象，客户端驱动程序在上一次调用 UcmUcsiPpmCreate 时收到的对象。

返回值

如果操作成功，则返回STATUS_SUCCESS。 否则，此方法可以返回相应的 NTSTATUS 值。

注解

UcmUcsiPpmStart 指示客户端驱动程序现在已准备好接收来自类扩展的请求。 在此调用后，类扩展将启动 OS 策略管理器 (OPM) 和命令处理程序状态机。

客户端驱动程序必须在调用 UcmUcsiPpmStop 后调用 UcmUcsiPpmStart 才能进行错误恢复。

此 DDI 启动类扩展为初始化 OPM 和命令处理程序状态机而需要执行的操作。 客户端驱动程序必须调用 UcmUcsiPpmStart 以通知 UcmUcsiCx 驱动程序已准备好接收 IOCTL 请求。 建议从 EVT_WDF_DEVICE_PREPARE_HARDWARE 回调函数或在系统调用此回调后进行此调用。

尝试在 PPM 启动后启动它会导致错误情况。

客户端调用 UcmUcsiPpmStart 后，类扩展会向 PPM 固件发送大量命令，以获取 PPM 和连接器功能及其状态。 由于与固件的交互次数很多，我们强烈建议 UcmUcsiCx 客户端实现者在启动期间调用此 DDI 一次，而不是从低功率状态（如 D0Entry 回调）恢复时调用此 DDI。 当客户端实现 S0 闲行时尤其如此。

要求

要求 值
最低 KMDF 版本 1.27
最低 UMDF 版本 N/A
标头 Ucmucsippm.h (包括 UcmUcsiCx.h)
Library UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL