EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS 콜백 함수(ucxcontroller.h)

  • 아티클

UCX는 이 콜백을 호출하여 호스트 컨트롤러 특성을 검색합니다.

구문

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

매개 변수

[in] UcxController

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

[out] UcxControllerTransportCharacteristics

호스트 컨트롤러의 클라이언트 드라이버가 전송 특성으로 채우는 UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS 구조체에 대한 포인터입니다.

반환 값

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

설명

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

이 콜백 함수는 선택 사항입니다. 전송 특성이 변경될 때마다 클라이언트 드라이버는 UCX에 새로운 함수 UcxControllerNotifyTransportCharacteristicsChange를 사용하여 특성 중 하나가 변경되었음을 알릴 책임이 있습니다.

요구 사항

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

추가 정보

UcxControllerCreate