共用方式為

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。

要求

要求 價值
最低 KMDF 版本 1.27
最低 UMDF 版本 N/A
標頭 ucmucsippm.h （包括 UcmUcsiCx.h）
連結庫 UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL