UcmTcpciPortControllerStart 函式 (ucmtcpciportcontroller.h)

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

語法

NTSTATUS UcmTcpciPortControllerStart(
  UCMTCPCIPORTCONTROLLER PortControllerObject
);

參數

PortControllerObject

處理客戶端驅動程式在先前呼叫 UcmTcpciPortControllerCreate中所收到的埠控制器物件。

傳回值

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

傳回碼	Description
STATUS_INVALID_DEVICE_REQUEST	埠控制器已處於 [開始] 狀態。
STATUS_INVALID_HANDLE	未藉由呼叫 UcmTcpciPortControllerSetHardwareRequestQueue 來設定硬體要求佇列。

備註

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

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

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

開機時，如果 BIOS 已經交涉 PD 合約，UcmTcpciCx 就會從未連結的狀態開始。

規格需求

需求	值
最低支援的用戶端	Windows 10
最低支援的伺服器	Windows Server 2016
目標平台	Windows
標頭	ucmtcpciportcontroller.h
程式庫	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

另請參閱

UcmTcpciPortControllerStop