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

추가 정보