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_CONFIGUCMTCPCI_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