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