UcmTcpciDeviceInitialize 函数 (ucmtcpcidevice.h)

初始化 UcmTcpciCx) (USB 类型 C 端口控制器接口框架扩展。

语法

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

WdfDevice

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

Config

指向调用方提供的 UCMTCPCI_DEVICE_CONFIG 结构的指针，该结构通过调用 UCMTCPCI_DEVICE_CONFIG_INIT进行初始化。此值不能为 NULL。

(NTSTATUS) 如果操作成功，该方法将返回STATUS_SUCCESS。否则，此方法可能会返回相应的 NTSTATUS 错误代码。

返回代码	说明
STATUS_INFO_LENGTH_MISMATCH	Config 指向的结构的大小无效。大小必须为UCMTCPCI_DEVICE_CONFIG。
STATUS_INVALID_DEVICE_STATE	框架设备对象的即插即用状态未初始化。在驱动程序的 EVT_WDF_DRIVER_DEVICE_ADD 实现中调用 UcmTcpciDeviceInitialize。

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