创建用于向 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 错误代码。
| 返回代码 | 描述 |
|---|---|
|
框架设备对象的句柄无效。 |
|
配置 或 配置>功能指向的结构的大小无效。 必须分别大小为 UCMTCPCI_PORT_CONTROLLER_CONFIG 或 UCMTCPCI_PORT_CONTROLLER_CAPABILITIES。 |
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 10 |
| 支持的最低服务器 | Windows Server 2016 |
| 目标平台 | 窗户 |
| 标头 | ucmtcpciportcontroller.h |
| 库 | Ucmtcpcicxstub.lib |
| IRQL | PASSIVE_LEVEL |