UcmUcsiPpmStop 函数（ucmucsippm.h）

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

语法

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

[in] PpmObject

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

没有

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

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

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

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