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

참고 항목

• UcmConnectorCreate