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 |