UcmUcsiPpmStop 函式 (ucmucsippm.h)

指示UcmUcsiCx類別延伸模組停止將要求傳送至客戶端驅動程式。

語法

void UcmUcsiPpmStop(
  [in] UCMUCSIPPM PpmObject
);

參數

[in] PpmObject

平台原則管理員的句柄 (PPM) 物件，用戶端驅動程式在先前呼叫 UcmUcsiPpmCreate 中收到。

傳回值

無

備註

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