UcmUcsiConnectorCollectionCreate 函数 (ucmucsippm.h)

项目
02/26/2024

使用 UcmUcsiCx 创建连接器集合对象。

语法

NTSTATUS UcmUcsiConnectorCollectionCreate(
  [in]  WDFDEVICE                    WdfDevice,
  [in]  PWDF_OBJECT_ATTRIBUTES       Attributes,
  [out] UCMUCSI_CONNECTOR_COLLECTION *ConnectorCollection
);

参数

[in] WdfDevice

客户端驱动程序在上一次调用 WdfDeviceCreate 时收到的框架设备对象的句柄。

[in] Attributes

指向调用方提供的 WDF_OBJECT_ATTRIBUTES 结构的指针，该结构包含新连接器集合对象的属性。此参数是可选的，可以WDF_NO_OBJECT_ATTRIBUTES。

[out] ConnectorCollection

指向接收新连接器集合对象的句柄的位置的指针。

返回值

如果操作成功，则返回STATUS_SUCCESS。否则，此方法可以返回相应的 NTSTATUS 值。

注解

集合对象是创建平台策略管理器 (PPM) 对象所必需的。客户端驱动程序通过调用 UcmUcsiPpmCreate 创建对象。驱动程序不得在 UcmUcsiPpmCreate 之后调用 [UcmUcsiConnectorCollectionCreate]，因为它不会对现有的 PPM 对象产生任何影响。

即使通过传递WDF_NO_ATTRIBUTES调用 UcmUcsiConnectorCollectionCreate 时，连接器集合对象也是 WDFOBJECT 的父对象。对象的生存期由框架管理。