UcmConnectorPowerDirectionChanged 함수(ucmmanager.h)

파트너 커넥터의 새 전원 역할을 사용하여 USB 커넥터 관리자 프레임워크 확장(UcmCx)을 알 수 있습니다.

구문

void UcmConnectorPowerDirectionChanged(
  [in] UCMCONNECTOR   Connector,
  [in] BOOLEAN        Success,
  [in] UCM_POWER_ROLE CurrentPowerRole
);

매개 변수

[in] Connector

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

[in] Success

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

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

[in] CurrentPowerRole

새 데이터 역할을 나타내는 UCM_POWER_ROLE 형식 플래그 중 하나입니다.

반환 값

없음

설명

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

커넥터 파트너가 연결된 경우 UcmCx는 CurrentPowerRole 값에 따라 파트너의 전원 역할을 업데이트합니다.

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

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

요구 사항

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

추가 정보

• UcmConnectorCreate