UcmConnectorDataDirectionChanged 함수(ucmmanager.h)

USB 커넥터 관리자 프레임워크 확장(UcmCx)에 데이터 역할 변경의 새 데이터 역할을 알 수 있습니다.

구문

void UcmConnectorDataDirectionChanged(
  [in] UCMCONNECTOR  Connector,
  [in] BOOLEAN       Success,
  [in] UCM_DATA_ROLE CurrentDataRole
);

매개 변수

[in] Connector

클라이언트 드라이버가 UcmConnectorCreate에 대한 이전 호출에서 받은 커넥터 개체에 대한 핸들입니다.

[in] Success

EVT_UCM_CONNECTOR_SET_DATA_ROLE 사용하여 UcmCx에서 시작한 데이터 역할 교환의 실패를 나타내는 데 사용됩니다.

TRUE이면 작업이 성공했습니다. FALSE, 그렇지 않으면 입니다.

[in] CurrentDataRole

새 데이터 역할을 나타내는 UCM_TYPEC_PARTNER 값입니다.

반환 값

없음

설명

UcmConnectorDataDirectionChanged 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 인라인 함수가 적절한 NTSTATUS 값을 반환할 수 있습니다.

커넥터 파트너가 연결된 경우 UcmCx는 CurrentDataRole 값에 따라 파트너의 데이터 역할을 업데이트합니다. 예를 들어 클라이언트 드라이버가 데이터 역할을 UcmTypeCPortStateUfp로 변경하는 경우 UcmCx는 커넥터 파트너의 역할을 UcmTypeCPortStateDfp로 업데이트합니다.

UcmCx는 커넥터의 데이터 역할을 변경할 수 있으며 EVT_UCM_CONNECTOR_SET_DATA_ROLE 호출합니다. 해당 호출에 대한 응답으로 클라이언트는 DR_Swap 작업을 수행하고 UcmConnectorDataDirectionChanged를 호출하여 작업의 성공/실패를 나타내야 합니다.

또는 클라이언트 드라이버가 역할 교환을 자율적으로 수행하도록 선택하거나 파트너가 역할 교환을 수행할 수 있습니다. 두 경우 모두 역할 교환이 완료되면 드라이버는 UcmConnectorDataDirectionChanged를 사용하여 UcmCx에 새 역할을 보고해야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
최소 KMDF 버전 1.15
최소 UMDF 버전 2.15
머리글 ucmmanager.h(Ucmcx.h 포함)
라이브러리 UcmCxstub.lib
IRQL PASSIVE_LEVEL

추가 정보