共用方式為

UcmUcsiPpmStart 函式 （Ucmucsippm.h）

  • 發行項

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

語法

NTSTATUS UcmUcsiPpmStart(
  [in] UCMUCSIPPM PpmObject
);

參數

[in] PpmObject

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

傳回值

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

言論

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

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

此 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