EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE 콜백 함수(udecxusbdevice.h)

USB 디바이스 에뮬레이션 클래스 확장(UdeCx)은 대체 설정을 선택하거나, 현재 엔드포인트를 사용하지 않도록 설정하거나, 동적 엔드포인트를 추가하여 구성을 변경하기 위해 이 콜백 함수를 호출합니다.

구문

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;

void EvtUdecxUsbDeviceEndpointsConfigure(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] WDFREQUEST Request,
  [in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}

매개 변수

[in] UdecxUsbDevice

UDE 디바이스 개체에 대한 핸들입니다. 클라이언트 드라이버는 UdecxUsbDeviceCreate에 대한 이전 호출에서 이 개체를 만들었습니다.

[in] Request

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

[in] Params

구성 옵션을 설명하는 UDECX_ENDPOINTS_CONFIGURE_PARAMS 구조체에 대한 포인터입니다.

반환 값

없음

설명

클라이언트 드라이버는 구현에 대한 함수 포인터를 제공하여 UdecxUsbDeviceInitSetStateChangeCallbacks 에 대한 이전 호출에서 이 콜백 함수를 등록했습니다.

클래스 확장은 이 콜백 함수를 호출하여 하나 이상의 새 엔드포인트를 하드웨어로 구성하도록 클라이언트 드라이버에 요청하거나 하나 이상의 기존 엔드포인트가 더 이상 사용되지 않을 때 드라이버에 알릴 수 있습니다.

엔드포인트를 만든 후 각 새 엔드포인트에 대해 클라이언트 드라이버는 요청을 완료하기 전에 UdecxUsbEndpointSetWdfIoQueue 를 호출해야 합니다.

엔드포인트를 해제한 후 클라이언트 드라이버는 엔드포인트와 연결된 프레임워크 큐 개체를 사용하면 안 됩니다. 클래스 확장은 향후 요청을 방지하기 위해 해당 큐를 제거된 것으로 간주합니다.

클래스 확장은 이 콜백을 통해 새 구성 값 또는 대체 설정을 요청할 수도 있습니다.

이 호출은 비동기적입니다. 클라이언트 드라이버는 클래스 확장에서 전달된 요청을 완료하여 상태 완료를 신호로 표시해야 합니다.

요구 사항

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

추가 정보

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

UdecxUsbEndpointSetWdfIoQueue

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