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。

要求

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