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
머리글 ucmmanager.h(Ucmcx.h 포함)
라이브러리 UcmCxstub.lib
IRQL PASSIVE_LEVEL

추가 정보

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate