EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION 콜백 함수(ucxcontroller.h)

UCX는 이 콜백 함수를 호출하여 변경이 발생할 때 클라이언트 드라이버가 알림을 보내야 하는 전송 특성에서 기본 설정을 지정합니다.

구문

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;

void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
  [in] UCXCONTROLLER UcxController,
  [in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}

매개 변수

[in] UcxController

UcxControllerCreate 메서드에 대한 이전 호출에서 클라이언트 드라이버가 받은 UCX 컨트롤러에 대한 핸들입니다.

[in] ChangeNotificationFlags

UCX에 관심이 있는 형식 전송 특성을 나타내는 플래그의 비트 옵션입니다. 플래그는 UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS 정의됩니다.

반환 값

없음

설명

작업이 성공하면 콜백 함수는 STATUS_SUCCESS 반환하거나 NT_SUCCESS(상태)이 TRUE인 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)이 FALSE와 같은 상태 값을 반환해야 합니다.

UCX 클라이언트 드라이버는 UcxControllerCreate 메서드를 호출하여 UCX(USB 호스트 컨트롤러 확장)에 구현을 등록합니다.

효율적인 전력 소비를 위해 UCX는 이 콜백 함수를 호출하여 UCX에 관심이 있는 전송 특성을 지정합니다.

클라이언트 드라이버가 컨트롤러의 전송 특성에 대한 변경 내용을 계속 찾는 경우일 수 있습니다. 이로 인해 전력 소비가 높아질 수 있으며 해당 변경 알림에 등록된 USB 디바이스 드라이버가 없는 경우 비효율적일 수 있습니다. 전력 소비를 최적화하기 위해 UCX는 이 콜백 함수를 호출하여 클라이언트 드라이버에 변경 내용에 대해 등록된 클라이언트가 있는지 알 수 있도록 합니다. 이 콜백 함수는 변경 알림 플래그를 매개 변수로 전달합니다. 플래그가 설정되면 하나 이상의 디바이스 드라이버가 등록되었음을 나타냅니다. 플래그가 설정되지 않은 경우 등록된 클라이언트가 없으므로 컨트롤러가 전원을 최적화할 수 있습니다.

참고

컨트롤러 드라이버가 이러한 콜백 함수를 등록하거나 사용하는 것은 선택 사항입니다. UCX에서 등록된 클라이언트가 없음을 표시한 경우에도 컨트롤러 드라이버가 변경 알림을 호출하는 것이 유효합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1709
지원되는 최소 서버	Windows Server 2016
대상 플랫폼	Windows
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	ucxcontroller.h(Ucxclass.h 포함)
IRQL	PASSIVE_LEVEL

추가 정보

• UcxControllerCreate