UcmUcsiPpmStop 函数 (ucmucsippm.h)

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

语法

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

[in] PpmObject

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

无

UcmUcsiPpmStop 指示客户端驱动程序不再准备好接收来自类扩展的请求。类扩展保证在此调用返回后不会向客户端发出任何请求。驱动程序在遇到错误并希望类扩展停止发送 PPM 请求时，应调用此 DDI。调用完成后，驱动程序应使用 UcmUcsiPpmStart 再次启动 PPM。

客户端驱动程序应在驱动程序卸载时调用此 DDI。此调用指示类扩展开始拆毁其内部状态机。建议客户端从其EVT_WDF_DEVICE_RELEASE_HARDWARE回调调用 UcmUcsiPpmStop 。

由于 UcmUcsiPpmStop 依赖于通过客户端驱动程序提供的电源管理的 WDFQUEUE 将 UCSI 命令发送到 PPM，因此尝试从 EVT_WDF_DEVICE_D0_EXIT 回调调用此函数会导致失败。这是因为此时，队列的调度入口已关闭。

UcmUcsiPpmStop 返回后，可以调用 UcmUcsiPpmStart 以再次启动 PPM。