共用方式為

UcmUcsiPpmStart 函式 (Ucmucsippm.h)

  • 發行項

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

語法

NTSTATUS UcmUcsiPpmStart(
  [in] UCMUCSIPPM PpmObject
);

參數

[in] PpmObject

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

傳回值

如果作業成功，則傳回STATUS_SUCCESS。 否則，這個方法可以傳回適當的 NTSTATUS 值。

備註

UcmUcsiPpmStart 指出用戶端驅動程式現在已準備好從類別延伸模組接收要求。 在此呼叫時，類別延伸模組會啟動OS原則管理員 (OPM) 和命令處理程式狀態機器。

用戶端驅動程式在呼叫UcmUcsiPpmStop以進行錯誤復原之後，必須呼叫 UcmUcsiPpmStart 。

這個 DDI 會啟動類別延伸模組需要執行的作業，以初始化 OPM 和命令處理程式狀態機器。 用戶端驅動程序必須呼叫 UcmUcsiPpmStart ，以通知UcmUcsiCx驅動程式已準備好接收IOCTL要求。 建議您從 EVT_WDF_DEVICE_PREPARE_HARDWARE 回呼函式，或在系統呼叫此回呼之後進行此呼叫。

嘗試在 PPM 啟動之後啟動會導致錯誤狀況。

用戶端呼叫 UcmUcsiPpmStart之後，類別延伸模組會將一些命令傳送至 PPM 韌體，以取得 PPM 和連接器功能及其狀態。 由於與韌體進行大量互動，強烈建議UcmUcsiCx用戶端實作者在啟動期間呼叫此 DDI，而不是從低電源狀態繼續，例如 D0Entry 回呼。 當用戶端實作 S0 閑置時，這特別適用。

規格需求

需求 值
最小 KMDF 版本 1.27
最低UMDF版本 N/A
標頭 Ucmucsippm.h (包括 UcmUcsiCx.h)
程式庫 UcmUcsiCxStub.lib
IRQL PASSIVE_LEVEL