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.");

必要条件

関連項目

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate を する