UdecxUsbDeviceInitSetEndpointsType 함수(udecxusbdevice.h)

클라이언트 드라이버가 가상 USB 디바이스를 만드는 데 사용하는 초기화 매개 변수의 엔드포인트 유형(단순 또는 동적)을 나타냅니다.

구문

void UdecxUsbDeviceInitSetEndpointsType(
  [in, out] PUDECXUSBDEVICE_INIT UdecxUsbDeviceInit,
  [in]      UDECX_ENDPOINT_TYPE  UdecxEndpointType
);

매개 변수

[in, out] UdecxUsbDeviceInit

가상 USB 디바이스에 대한 초기화 매개 변수를 포함하는 WDF 할당 구조체에 대한 포인터입니다. 클라이언트 드라이버는 UdecxUsbDeviceInitAllocate에 대한 이전 호출에서 이 포인터를 검색했습니다.

[in] UdecxEndpointType

USB 엔드포인트의 형식을 나타내는 UDECX_ENDPOINT_TYPE 형식 값입니다.

반환 값

없음

설명

가상 USB 디바이스를 만들기 전에 클라이언트 드라이버는 지원하는 엔드포인트 유형을 나타내야 합니다. 두 가지 형식 중 하나를 지원할 수 있습니다( UDECX_ENDPOINT_TYPE 정의됨).

  • 단순 엔드포인트-클라이언트 드라이버는 디바이스에 연결하기 전에 모든 엔드포인트 개체를 만듭니다. 디바이스에는 인터페이스당 하나의 구성과 하나의 인터페이스 설정만 있어야 합니다.
  • 동적 엔드포인트-클라이언트는 EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE 콜백 함수에 엔드포인트 개체를 만듭니다. USB 디바이스 에뮬레이션 클래스 확장(UdeCx)은 엔드포인트를 추가하거나 구성하라는 요청을 받으면 드라이버의 구현을 호출합니다.
UdecxUsbDeviceInit는 엔드포인트와 관련된 콜백 함수에 대한 포인터를 포함하는 불투명 구조체입니다. 클라이언트 드라이버가 동적 엔드포인트를 지원하는 경우 드라이버에서 이러한 콜백 함수를 구현해야 합니다. 이 메서드를 호출하기 전에 클라이언트 드라이버는 UdecxUsbDeviceInitSetStateChangeCallbacks를 호출하여 해당 포인터를 설정해야 합니다.

요구 사항

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

추가 정보

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

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE

USB 엔드포인트

UdecxUsbDeviceInitAllocate

UdecxUsbDeviceInitSetStateChangeCallbacks

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