UcmUcsiConnectorCollectionCreate 函数 (ucmucsippm.h)

使用 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。 对象的生存期由框架管理。

要求

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

另请参阅

WdfDeviceCreate

WDF_OBJECT_ATTRIBUTES

UcmUcsiPpmCreate

UcmUcsiConnectorCollectionAddConnector