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 클라이언트 드라이버 작성