通过

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。

配置 中传递的结构包含使用 USB Type-C 连接器类扩展（UcmCx ）创建连接器所需的 Type-C 连接器信息（UcmConnectorCreate），并且无法通过 UCSI 命令（如 GetCapability 或 GetConnectorCapability）从 PPM 获取。

配置 结构还包含连接器 ID，这是 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