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 |