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 結構的指標，該結構是藉由呼叫 UCMUCSI_PPM_CONFIG_INIT初始化。 ConnectorCollectionHandle 成員必須設定為先前呼叫 UcmUcsiConnectorCollectionCreate 中所擷取的句柄。

[in] Attributes

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

[out] PPMObject

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

傳回值

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

備註

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

在 Config 中傳遞的結構包含使用 USB Type-C 連接器類別擴充功能建立連接器所需的 Type-C 連接器資訊， (UcmCx) 使用 UcmConnectorCreate ，而且無法透過 UCSI 命令從 PPM 取得，例如 GetCapability 或 GetConnectorCapability。

Config 結構也包含連接器標識碼，這是 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