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 中传递的结构包含使用 UcmConnectorCreate 创建具有 USB Type-C 连接器类扩展的连接器所需的 Type-C 连接器信息 (UcmCx) ，并且无法通过 UCSI 命令（如 GetCapability 或 GetConnectorCapability）从 PPM 获取。

Config 结构还包含连接器 ID，USB 类型 C 连接器和 USB 端口之间的一对一映射需要这些 ID。

PPM 对象也是 WDFOBJECT，并与客户端驱动程序提供的 WDFDEVICE 句柄创建一对一关联。

即使通过传递WDF_NO_ATTRIBUTES调用 UcmUcsiPpmCreate，PPM 对象也会父级到 WDFOBJECT。 对象的生存期由框架管理。

要求

要求	值
最低 KMDF 版本	1.27
最低 UMDF 版本	N/A
标头	Ucmucsippm.h (包括 UcmUcsiCx.h)
Library	UcmUcsiCxStub.lib
IRQL	PASSIVE_LEVEL