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 |
| 目標平臺 | 窗戶 |
| 最低 KMDF 版本 | 1.15 |
| 最低 UMDF 版本 | 2.15 |
| 標頭 | ucmmanager.h （包括 Ucmcx.h） |
| 連結庫 | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |
另請參閱
UCM_CONNECTOR_TYPEC_ATTACH_PARAMS