EVT_UCX_USBDEVICE_GET_CHARACTERISTIC 콜백 함수(ucxusbdevice.h)
UCX는 이 콜백을 호출하여 디바이스 특성을 검색합니다.
구문
EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;
NTSTATUS EvtUcxUsbdeviceGetCharacteristic(
[in] UCXCONTROLLER UcxController,
[in] UCXUSBDEVICE UcxUsbDevice,
[in, out] PUCX_USBDEVICE_CHARACTERISTIC UcxUsbDeviceCharacteristic
)
{...}
매개 변수
[in] UcxController
UcxControllerCreate 메서드에 대한 이전 호출에서 클라이언트 드라이버가 받은 UCX 컨트롤러에 대한 핸들입니다.
[in] UcxUsbDevice
UcxUsbDeviceCreate 메서드에 대한 이전 호출에서 클라이언트 드라이버가 받은 USB 디바이스를 나타내는 UCX 개체에 대한 핸들입니다.
[in, out] UcxUsbDeviceCharacteristic
호출자가 관심이 있는 특성의 형식을 포함하는 UCX_USBDEVICE_CHARACTERISTIC 구조체에 대한 포인터입니다. 클라이언트 드라이버는 요청된 특성의 값을 채웁니다. 예를 들어 형식이 UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY 나타내는 경우 드라이버는 PathDelay 멤버가 가리키는 UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY 구조를 적절한 최대값 및 송신 경로 지연 값으로 채웁니다.
반환 값
작업이 성공하면 콜백 함수는 STATUS_SUCCESS 반환하거나 NT_SUCCESS(상태)이 TRUE인 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)가 FALSE와 같은 상태 값을 반환해야 합니다.
설명
UCX 클라이언트 드라이버는 UcxUsbDeviceCreate 메서드를 호출하여 UCX(USB 호스트 컨트롤러 확장)에 구현을 등록합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 10, 버전 1709 |
지원되는 최소 서버 | Windows Server 2016 |
대상 플랫폼 | Windows |
최소 KMDF 버전 | 1.0 |
최소 UMDF 버전 | 2.0 |
머리글 | ucxusbdevice.h(Ucxclass.h 포함) |
IRQL | <=DISPATCH_LEVEL |