UcmInitializeDevice 函数 (ucmmanager.h)

初始化 UcmCx) (USB 连接器管理器框架扩展。

语法

NTSTATUS UcmInitializeDevice(
  [in] WDFDEVICE           WdfDevice,
  [in] PUCM_MANAGER_CONFIG Config
);

参数

[in] WdfDevice

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

[in] Config

指向调用方提供的 UCM_MANAGER_CONFIG 结构的指针,该结构通过调用 UCM_MANAGER_CONFIG_INIT进行初始化。

返回值

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

注解

此方法初始化 UcmCx 并分配所需的资源、注册 PnP 事件并设置 I/O 目标。 客户端驱动程序必须在驱动程序的 EVT_WDF_DRIVER_DEVICE_ADD 实现中调用此方法。

要求

要求
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
最低 KMDF 版本 1.15
最低 UMDF 版本 2.15
标头 ucmmanager.h (包括 Ucmcx.h)
Library UcmCxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

UCM_MANAGER_CONFIG

UCM_MANAGER_CONFIG_INIT