共用方式為

UcmUcsiPpmCreate 函式 （Ucmucsippm.h）

  • 發行項

建立平台原則管理員 （PPM） 物件。

語法

NTSTATUS UcmUcsiPpmCreate(
  [in]  WDFDEVICE              WdfDevice,
  [in]  PUCMUCSI_PPM_CONFIG    Config,
  [in]  PWDF_OBJECT_ATTRIBUTES Attributes,
  [out] UCMUCSIPPM             *PPMObject
);

參數

[in] WdfDevice

用戶端驅動程式在上一次呼叫 WdfDeviceCreate中收到的架構裝置物件的句柄。

[in] Config

呼叫 UCMUCSI_PPM_CONFIG_INIT所初始化之呼叫端所提供之 UCMUCSI_PPM_CONFIG 結構的指標。 ConnectorCollectionHandle 成員必須設定為先前呼叫 UcmUcsiConnectorCollectionCreate 中所擷取的句柄。

[in] Attributes

由呼叫端提供之 WDF_OBJECT_ATTRIBUTES 結構的指標，其中包含新連接器集合對象的屬性。 這個參數是選擇性的，而且可以WDF_NO_OBJECT_ATTRIBUTES。

[out] PPMObject

接收新 PPM 物件句柄之位置的指標。

傳回值

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

言論

用戶端驅動程序應該從 EVT_WDF_DEVICE_PREPARE_HARDWARE 回呼函式呼叫 UcmUcsiPpmCreate。

Config 中傳遞的結構包含使用 Type-C UcmConnectorCreate 從 PPM 透過 GetCapability 或 GetConnectorCapability 等 UCSI 命令建立連接器所需的 Type-C 連接器資訊。

組態 結構也包含連接器標識碼，這是USB Type-C 連接器與USB埠之間的一對一對應所需的。

PPM 物件也是 WDFOBJECT，並與客戶端驅動程式所提供的 WDFDEVICE 句柄建立一對一關聯。

即使透過傳遞WDF_NO_ATTRIBUTES呼叫UcmUcsiPpmCreate，PPM物件仍會父系至WDFOBJECT。 物件的存留期是由架構所管理。

要求

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