UcmTcpciPortControllerStart 函式 （ucmtcpciportcontroller.h）

向UcmTcpciCx類別延伸模組指出，客戶端驅動程式現在已準備好為埠控制器服務硬體要求。

語法

NTSTATUS UcmTcpciPortControllerStart(
  UCMTCPCIPORTCONTROLLER PortControllerObject
);

參數

PortControllerObject

處理用戶端驅動程式在上一次呼叫中收到的埠控制器物件，UcmTcpciPortControllerCreate。

傳回值

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

言論

用戶端驅動程式收到埠控制器物件的 UCMPORTCONTROLLER 句柄之後，驅動程式會呼叫此方法，以通知類別延伸模塊驅動程式可以開始接收硬體要求。 這個方法呼叫可讓用戶端驅動程式在埠控制器對象上執行架構內容空間的初始化，然後類別延伸模組才能叫用驅動程式的回呼函式或埠控制器物件的要求。 驅動程式無法呼叫 UcmTcpciPortControllerAlert 或 UcmTcpciPortControllerStop，直到埠控制器啟動為止。

用戶端驅動程式會在呼叫 UcmTcpciPortControllerCreate 並初始化其內容結構之後，於 WDF_OBJECT_ATTRIBUTES 結構中指定為 Attributes 參數值之後，立即呼叫此方法。 驅動程式必須假設類別延伸模組可能會在 UcmTcpciPortControllerStart 之前提交要求， 從這個 DDI 呼叫內傳回。 如果驅動程式在呼叫 UcmTcpciPortControllerStart 時持有鎖定，而且嘗試在處理硬體要求時取得鎖定（在其硬體要求佇列回呼中），可能會導致死結。

呼叫 UcmTcpciPortControllerStart 啟動已處於 Start 狀態的埠控制器物件，會導致錯誤。

開機時，如果 BIOS 已經交涉過 PD 合約，UcmTcpciCx 會從未鏈接的狀態開始。

要求

另請參閱

UcmTcpciPortControllerStop