UcmTcpciDeviceInitialize 函式 (ucmtcpcidevice.h)

初始化 UcmTcpciCx (UcmTcpciCx) 的 USB Type-C 連接埠控制器介面擴充功能。

語法

NTSTATUS UcmTcpciDeviceInitialize(
  WDFDEVICE               WdfDevice,
  PUCMTCPCI_DEVICE_CONFIG Config
);

WdfDevice

用戶端驅動程式在先前呼叫 WdfDeviceCreate 中所收到的架構裝置物件的句柄。

Config

呼叫端所提供之UCMTCPCI_DEVICE_CONFIG 結構的指標，該結構會藉由呼叫 UCMTCPCI_DEVICE_CONFIG_INIT 初始化。這個值不可以是 NULL。

(NTSTATUS) 如果作業成功，此方法會傳回STATUS_SUCCESS。否則，這個方法可能會傳回適當的 NTSTATUS 錯誤碼。

傳回碼	Description
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 目標。