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

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate