UdecxWdfDeviceAddUsbDeviceEmulation 함수(udecxwdfdevice.h)

  • 아티클

호스트 컨트롤러 및 컨트롤러에 연결된 가상 USB 디바이스와 관련된 작업을 지원하도록 프레임워크 디바이스 개체를 초기화합니다.

구문

NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
       WDFDEVICE                WdfDevice,
  [in] PUDECX_WDF_DEVICE_CONFIG Config
);

매개 변수

WdfDevice

WdfDeviceCreate에 대한 이전 호출에서 클라이언트 드라이버가 검색한 프레임워크 디바이스 개체에 대한 핸들입니다.

[in] Config

클라이언트 드라이버가 UDECX_WDF_DEVICE_CONFIG_INIT 호출하여 초기화한 UDECX_WDF_DEVICE_CONFIG 구조체에 대한 포인터입니다.

반환 값

메서드는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 메서드가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

설명

에뮬레이트된 호스트 컨트롤러 및 USB 디바이스에 대한 UDE 클라이언트 드라이버는 WdfDeviceCreate 호출 후에 이 메서드를 호출해야 합니다.

이 호출 중에 클라이언트 드라이버 제공 이벤트 콜백 구현도 등록됩니다. UDECX_WDF_DEVICE_CONFIG 적절한 멤버를 호출하여 해당 함수에 대한 함수 포인터를 제공합니다.

이 메서드를 사용하면 프레임워크 디바이스 개체가 연결된 USB 디바이스로 전송된 IOCTL 요청을 처리하는 데 필요한 다양한 큐를 처리하는 등 컨트롤러 및 루트 허브와 관련된 작업을 수행할 수 있습니다.

요구 사항

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

추가 정보

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

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