UcmConnectorTypeCAttach 函式 (ucmmanager.h)
在連結合作夥伴連接器時，通知 USB 連接器管理員架構延伸模組 (UcmCx) 。
語法
NTSTATUS UcmConnectorTypeCAttach(
[in] UCMCONNECTOR Connector,
[in] PUCM_CONNECTOR_TYPEC_ATTACH_PARAMS Params
);
參數
[in] Connector
處理客戶端驅動程式在先前呼叫 UcmConnectorCreate中所收到的連接器物件。
[in] Params
已透過呼叫 UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT 初始化之驅動程式配置的UCM_CONNECTOR_TYPEC_ATTACH_PARAMS指標。
傳回值
如果作業成功，UcmConnectorTypeCAttach 會傳回STATUS_SUCCESS。 否則，這個方法可以傳回適當的 NTSTATUS 值。
備註
偵測到合作夥伴連接器的連線時，用戶端驅動程式會呼叫此方法，以通知 UcmCx 與合作夥伴連接器的相關信息。 此資訊包括連接器角色、下流或上游面向埠、目前連接器的數量可以繪製或傳遞，以及充電狀態。 UcmCx 會使用該資訊來執行特定作業。 例如，它可能會判斷連接夥伴連接器的角色，並在主機或周邊模式中設定USB控制器。
一般而言，每個 UcmConnectorTypeCAttach 呼叫都有後續 的UcmConnectorTypeCDetach 呼叫，以在夥伴連接器中斷連結時通知UcmCx。 不過，當未連接上游埠的電源纜線 (Params-PortPartnerType> 設定為 UcmTypeCPortStatePoweredCableNoUfp) 時。 當偵測到上游埠到電源纜線時，客戶端驅動程式可以再次呼叫 UcmConnectorTypeCAttach 。
範例
UCM_CONNECTOR_TYPEC_ATTACH_PARAMS attachParams;
UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT(
&attachParams,
UcmTypeCPortStateDfp);
attachParams.CurrentAdvertisement = UcmTypeCCurrent1500mA;
status = UcmConnectorTypeCAttach(
Connector,
&attachParams);
if (!NT_SUCCESS(status))
{
TRACE_ERROR(
"UcmConnectorTypeCAttach() failed with %!STATUS!.",
status);
goto Exit;
}
TRACE_INFO("UcmConnectorTypeCAttach() succeeded.");
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 |
| 最低支援的伺服器 | Windows Server 2016 |
| 目標平台 | Windows |
| 最小 KMDF 版本 | 1.15 |
| 最低UMDF版本 | 2.15 |
| 標頭 | ucmmanager.h (包括 Ucmcx.h) |
| 程式庫 | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |
另請參閱
UCM_CONNECTOR_TYPEC_ATTACH_PARAMS