UcmTcpciPortControllerCreate 函数 (ucmtcpciportcontroller.h)

  • 项目

创建要注册到 UcmTcpciCx 的端口控制器对象。

语法

NTSTATUS UcmTcpciPortControllerCreate(
  WDFDEVICE                        WdfDevice,
  PUCMTCPCI_PORT_CONTROLLER_CONFIG Config,
  PWDF_OBJECT_ATTRIBUTES           Attributes,
  UCMTCPCIPORTCONTROLLER           *PortControllerObject
);

参数

WdfDevice

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

Config

指向通过调用 UCMTCPCI_PORT_CONTROLLER_CONFIG_INIT 初始化 的UCMTCPCI_PORT_CONTROLLER_CONFIG的指针。 此值不能为 NULL。

Attributes

指向 WDF_OBJECT_ATTRIBUTES 结构的指针，该结构包含驱动程序为新对象提供的属性。 此参数是可选的，可以 WDF_NO_OBJECT_ATTRIBUTES。

PortControllerObject

指向接收新端口控制器对象的句柄的位置的指针。

返回值

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

返回代码 说明
STATUS_INVALID_DEVICE_REQUEST
 框架设备对象的句柄无效。
STATUS_INFO_LENGTH_MISMATCH
 Config 或 Config->功能指向的结构的大小无效。 大小必须分别为 UCMTCPCI_PORT_CONTROLLER_CONFIG 或 UCMTCPCI_PORT_CONTROLLER_CAPABILITIES。

要求

要求 值
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 ucmtcpciportcontroller.h
Library Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate