共用方式為

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
目標平臺 窗戶
標頭 ucmtcpciportcontroller.h
連結庫 Ucmtcpcicxstub.lib
IRQL PASSIVE_LEVEL

另請參閱

EVT_WDF_DRIVER_DEVICE_ADD

UCMTCPCI_PORT_CONTROLLER_CONFIG

WdfDeviceCreate