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 呼び出しには、パートナー コネクタがデタッチされたときに UcmCx に通知する後続の UcmConnectorTypeCDetach 呼び出しがあります。 ただし、アップストリーム ポートのない電源ケーブルが接続されている場合 (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 |
| Header | ucmmanager.h (Ucmcx.h を含む) |
| Library | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |
こちらもご覧ください
UCM_CONNECTOR_TYPEC_ATTACH_PARAMS