다음을 통해 공유

UdecxWdfDeviceTryHandleUserIoctl 함수(udecxwdfdevice.h)

  • 아티클

사용자 모드 소프트웨어에서 보낸 IOCTL 요청을 처리하려고 시도합니다.

구문

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

매개 변수

UdecxWdfDevice

컨트롤러를 나타내는 프레임워크 디바이스 개체에 대한 핸들입니다. 클라이언트 드라이버는 UdecxWdfDeviceAddUsbDeviceEmulation에 대한 이전 호출에서 이 개체를 초기화했습니다.

[in] Request

IOCTL 요청을 나타내는 프레임워크 요청 개체에 대한 핸들입니다.

반환 값

TRUE는 USB 디바이스 에뮬레이션 클래스 확장(UdeCx)이 요청을 인식하고 완료했음을 나타냅니다(성공 또는 실패). 이 경우 클라이언트 드라이버는 요청을 완료하지 않아야 합니다. FALSE이면 이고, 그렇지 않으면 입니다. 드라이버가 요청을 완료해야 합니다.

설명

UDE 클라이언트 드라이버는 사용자 모드 소프트웨어에 호스트 컨트롤러 드라이버로 표시됩니다. 클라이언트 드라이버는 GUID_DEVINTERFACE_USB_HOST_CONTROLLER 디바이스 인터페이스 GUID를 등록하고 노출합니다. 사용자 모드 소프트웨어는 해당 GUID를 지정하여 디바이스에 대한 핸들을 열 수 있습니다. 소프트웨어는 해당 핸들을 사용하여 IOCTL 요청을 보낼 수 있습니다.

참고 다른 인터페이스의 IOCTL 코드는 USB 호스트 컨트롤러 인터페이스와 겹칠 수 있습니다. 이러한 I/O가 이 함수에 도달하면 IOCTL이 올바르게 처리되지 않습니다.
 
클라이언트 드라이버는 수신된 IOCTL을 처리할 필요가 없습니다. UdecxWdfDeviceTryHandleUserIoctl을 호출하여 클래스 확장에 요청을 보낼 수 있습니다. 클래스 확장이 요청을 표준 요청으로 인식하는 경우 요청을 완료합니다. 그렇지 않으면 호출이 실패하고 클라이언트 드라이버가 요청을 완료해야 합니다. 처리해야 하는 IOCTL 목록은 애플리케이션 및 서비스에 대한 USB IOCTL을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 10
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
최소 KMDF 버전 1.15
머리글 udecxwdfdevice.h(Udecx.h 포함)
라이브러리 Udecxstub.lib
IRQL PASSIVE_LEVEL

추가 정보

아키텍처: USB 디바이스 에뮬레이션(UDE)

UDE 클라이언트 드라이버 작성