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 |